trove-cli 0.0.0-stage → 0.2.0

package/dist/core/clean.js

@@ -0,0 +1,182 @@
+import { mapLimit } from './concurrency.js';
+import { chunkRemotePath, indexPath, objectRemotePath, } from './remote-layout.js';
+const DEFAULT_MIN_AGE_MS = 24 * 60 * 60 * 1000;
+const SAFE_DEVICE = /^[A-Za-z0-9._-]+$/;
+/** 递归枚举目录下的文件;优先用后端的批量列举,避免逐目录几千次往返。 */
+async function walkEntries(remote, dir) {
+    if (remote.listAll) {
+        return (await remote.listAll(dir)).map((e) => ({
+            path: e.name,
+            size: e.size,
+            mtime: e.mtime,
+        }));
+    }
+    const out = [];
+    for (const e of await remote.list(dir)) {
+        const p = `${dir}/${e.name}`;
+        if (e.type === 'directory')
+            out.push(...(await walkEntries(remote, p)));
+        else
+            out.push({ path: p, size: e.size, mtime: e.mtime });
+    }
+    return out;
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function addOrphan(out, entry, category, cutoff) {
+    // 时间缺失或不够旧:无法证明是残留,一律不删
+    if (entry.mtime === undefined || entry.mtime > cutoff)
+        return;
+    out.push({ path: entry.path, size: entry.size, mtime: entry.mtime, category });
+}
+/** 扫描远端,返回候选孤儿。任何读取异常都会抛出,由调用方中止整轮。 */
+export async function scanOrphans(remote, opts = {}) {
+    const now = opts.now ?? Date.now;
+    const cutoff = now() - (opts.minAgeMs ?? DEFAULT_MIN_AGE_MS);
+    const objects = [];
+    const skippedDevices = [];
+    let librarySkipped = false;
+    const skippedSkills = [];
+    for (const device of (await remote.listDevices()).filter((d) => SAFE_DEVICE.test(d) && d !== '.' && d !== '..')) {
+        const raw = await remote.readJson(indexPath(device));
+        const index = raw;
+        // 索引读不到/结构不对:无法判断引用关系,整个设备跳过
+        if (!index || !isObject(index) || !isObject(index.items)) {
+            skippedDevices.push(device);
+            continue;
+        }
+        const keep = new Set();
+        for (const item of Object.values(index.items)) {
+            if (!isObject(item) || typeof item.harness !== 'string')
+                continue;
+            if (item.layout === 'object' && typeof item.relPath === 'string') {
+                keep.add(objectRemotePath(device, item.harness, item.relPath));
+            }
+            else if (typeof item.key === 'string' && typeof item.generation === 'string') {
+                for (const c of Array.isArray(item.chunks) ? item.chunks : []) {
+                    if (!isObject(c))
+                        continue;
+                    keep.add(chunkRemotePath(device, item.harness, item.key, item.generation, {
+                        offset: Number(c.offset),
+                        length: Number(c.length),
+                    }));
+                }
+            }
+        }
+        for (const [prefix, category] of [
+            [`raw/${device}/chunks`, 'raw-chunk'],
+            [`raw/${device}/files`, 'raw-file'],
+        ]) {
+            for (const entry of await walkEntries(remote, prefix)) {
+                if (keep.has(entry.path))
+                    continue;
+                addOrphan(objects, entry, category, cutoff);
+            }
+        }
+    }
+    // library:任一设备分片读不到/结构不对就整体跳过,避免把在用的文件当孤儿
+    const shards = (await remote.list('library/index')).filter((e) => e.type === 'file' && e.name.endsWith('.json'));
+    if (shards.length === 0) {
+        librarySkipped = true;
+    }
+    else {
+        const parsed = [];
+        for (const shard of shards) {
+            const raw = await remote.readJson(`library/index/${shard.name}`);
+            if (!raw || !isObject(raw) || raw.v !== 1 || !isObject(raw.sessions)) {
+                librarySkipped = true;
+                break;
+            }
+            parsed.push(raw);
+        }
+        if (!librarySkipped) {
+            const keep = new Set();
+            const keepPrefixes = new Set();
+            for (const shard of parsed) {
+                for (const entry of Object.values(shard.sessions ?? {})) {
+                    if (entry?.path)
+                        keep.add(`library/${entry.path}`);
+                }
+            }
+            const sessions = await walkEntries(remote, 'library/sessions');
+            for (const e of sessions) {
+                // 多设备并集文件不在任何分片里,但统一索引引用它:整组保留
+                if (e.path.split('/').pop().startsWith('merged.'))
+                    keep.add(e.path);
+            }
+            const skills = await walkEntries(remote, 'library/skills');
+            const metaBySkill = new Map();
+            const skillDirs = new Set();
+            for (const e of skills) {
+                const m = /^library\/skills\/([^/]+)\//.exec(e.path);
+                if (!m)
+                    continue;
+                const safe = m[1];
+                skillDirs.add(safe);
+                if (/\/meta\/[^/]+\.json$/.test(e.path)) {
+                    metaBySkill.set(safe, [...(metaBySkill.get(safe) ?? []), e.path]);
+                    keep.add(e.path);
+                }
+            }
+            for (const safe of skillDirs) {
+                const metas = metaBySkill.get(safe);
+                // 没有 meta 或读取失败:无法确认版本引用,整个技能目录保留
+                if (!metas || metas.length === 0) {
+                    keepPrefixes.add(`library/skills/${safe}/`);
+                    skippedSkills.push(safe);
+                    continue;
+                }
+                let ok = true;
+                for (const metaPath of metas) {
+                    const raw = await remote.readJson(metaPath);
+                    if (!raw || !isObject(raw)) {
+                        ok = false;
+                        break;
+                    }
+                    const versions = Array.isArray(raw.versions) ? raw.versions : [];
+                    for (const v of versions) {
+                        if (isObject(v) && typeof v.hash === 'string') {
+                            keepPrefixes.add(`library/skills/${safe}/versions/${v.hash}/`);
+                        }
+                    }
+                }
+                if (!ok) {
+                    keepPrefixes.add(`library/skills/${safe}/`);
+                    skippedSkills.push(safe);
+                }
+            }
+            const prefixes = [...keepPrefixes];
+            const isKept = (path) => keep.has(path) || prefixes.some((p) => path.startsWith(p));
+            for (const entry of [...sessions, ...skills]) {
+                if (entry.path.includes('.tmp-'))
+                    continue;
+                if (isKept(entry.path))
+                    continue;
+                addOrphan(objects, entry, entry.path.startsWith('library/sessions/') ? 'library-session' : 'library-skill', cutoff);
+            }
+        }
+    }
+    const bytes = objects.reduce((n, o) => n + o.size, 0);
+    return { objects, bytes, skippedDevices, librarySkipped, skippedSkills };
+}
+/** 删除扫描结果;单条失败计入 failed,不中断整轮。 */
+export async function deleteOrphans(remote, scan, opts = {}) {
+    let deleted = 0;
+    let bytes = 0;
+    let failed = 0;
+    await mapLimit(scan.objects, remote.concurrencyHint?.() ?? 1, async (obj) => {
+        if (opts.signal?.aborted)
+            return;
+        try {
+            await remote.delete(obj.path);
+            deleted++;
+            bytes += obj.size;
+        }
+        catch {
+            failed++;
+        }
+    });
+    return { deleted, bytes, failed };
+}
+//# sourceMappingURL=clean.js.map

package/dist/core/clean.js.map

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

package/dist/core/collect.d.ts

@@ -0,0 +1,39 @@
+import { type Adapter } from '../adapters/index.js';
+import { type Progress } from '../progress.js';
+import type { State } from './state.js';
+export interface CollectOptions {
+    adapters: Adapter[];
+    deviceId: string;
+    vaultRoot: string;
+    state: State;
+    /** 0 = 不限制;否则只处理 sessionMtimeMs >= cutoff 的会话(Beacon Recent) */
+    cutoff: number;
+    progress?: Progress;
+    tmpDir?: string;
+    newGeneration?: () => string;
+    signal?: AbortSignal;
+}
+export interface CollectResult {
+    /** 命中白名单的文件/会话数(含窗口外) */
+    discovered: number;
+    /** 全量写入(新文件或重置)的条数 */
+    archived: number;
+    /** 增量追加的条数 */
+    appended: number;
+    /** 未变化跳过 */
+    skipped: number;
+    /** 因 --since 窗口被过滤 */
+    outOfWindow: number;
+    bytesCopied: number;
+    /** 本次涉及的会话数(按 harness + sessionKey 去重) */
+    sessions: number;
+    /** 本轮新归档/追加/重置的会话(harness:session),供 learn 只自动学新会话 */
+    changedSessions: string[];
+}
+/**
+ * collect:poll 骨架。发现 → 时间窗 → 游标对比 → 无损归档 → 落状态。
+ * 文件源与 SQLite 源最终都归约为"一个可增量复制的字节流"。
+ */
+export declare function collect(opts: CollectOptions): Promise<CollectResult>;
+/** 协作式中止:daemon 收到 SIGTERM 后不必等整轮跑完。 */
+export declare function throwIfAborted(signal?: AbortSignal): void;

package/dist/core/collect.js

@@ -0,0 +1,194 @@
+import { randomUUID } from 'node:crypto';
+import { access, mkdir, unlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { archiveFile } from './archive.js';
+import { hashBytes } from './chunker.js';
+import { discoverFiles } from '../adapters/file-source.js';
+import { OPENCODE_EXPORT_VERSION, OpenCodeStore } from '../adapters/opencode.js';
+import { isSessionPath } from '../adapters/index.js';
+import { validateRelPath } from './remote-layout.js';
+import { rawFilePath } from './layout.js';
+import { buildLibrary } from './library/build.js';
+import { silentProgress } from '../progress.js';
+function archivePath(vaultRoot, deviceId, harness, relPath) {
+    return rawFilePath(vaultRoot, deviceId, harness, relPath);
+}
+/**
+ * collect:poll 骨架。发现 → 时间窗 → 游标对比 → 无损归档 → 落状态。
+ * 文件源与 SQLite 源最终都归约为"一个可增量复制的字节流"。
+ */
+export async function collect(opts) {
+    const { adapters, deviceId, vaultRoot, state, cutoff } = opts;
+    const progress = opts.progress ?? silentProgress;
+    const tmpDir = opts.tmpDir ?? join(vaultRoot, '.trove-tmp');
+    await mkdir(tmpDir, { recursive: true });
+    const result = {
+        discovered: 0,
+        archived: 0,
+        appended: 0,
+        skipped: 0,
+        outOfWindow: 0,
+        bytesCopied: 0,
+        sessions: 0,
+        changedSessions: [],
+    };
+    const sessionSeen = new Set();
+    const changedSessions = new Set();
+    for (const adapter of adapters) {
+        if (adapter.kind === 'files') {
+            const files = await discoverFiles(adapter.source);
+            result.discovered += files.length;
+            progress.phase('collect', `${adapter.displayName}: ${files.length} 个文件`);
+            const sessionFiles = new Map();
+            let n = 0;
+            for (const f of files) {
+                throwIfAborted(opts.signal);
+                n++;
+                if (isSessionPath(adapter, f.relPath))
+                    sessionSeen.add(`${adapter.id}:${f.sessionKey}`);
+                if (cutoff && f.sessionMtimeMs < cutoff) {
+                    result.outOfWindow++;
+                    continue;
+                }
+                if (!validateRelPath(f.relPath))
+                    throw new Error(`非法路径(源文件): ${f.relPath}`);
+                const bucket = (state.sources[adapter.id] ??= {});
+                const r = await archiveFile({
+                    sourcePath: f.absPath,
+                    targetPath: archivePath(vaultRoot, deviceId, adapter.id, f.relPath),
+                    cursor: bucket[f.relPath],
+                    srcStat: { size: f.size, mtimeMs: f.mtimeMs },
+                    newGeneration: opts.newGeneration,
+                });
+                tally(result, r.action, r.bytesCopied);
+                if (r.cursor) {
+                    bucket[f.relPath] = {
+                        ...r.cursor,
+                        sessionKey: f.sessionKey,
+                        sessionMtimeMs: f.sessionMtimeMs,
+                    };
+                }
+                const list = sessionFiles.get(f.sessionKey) ?? [];
+                list.push(f.relPath);
+                sessionFiles.set(f.sessionKey, list);
+                if (r.action !== 'skip')
+                    changedSessions.add(`${adapter.id}:${f.sessionKey}`);
+                progress.item(f.relPath, n, files.length, r.bytesCopied);
+            }
+            continue;
+        }
+        // SQLite(OpenCode):按会话导出确定性 JSONL,再走同一套归档逻辑
+        // 数据库不存在 = 该工具未安装,静默跳过,不让缺库中断整轮同步
+        if (!(await fileExists(adapter.dbPath))) {
+            progress.phase('collect', `${adapter.displayName}: 0 个会话`);
+            continue;
+        }
+        const store = new OpenCodeStore(adapter.dbPath);
+        try {
+            const sessions = store.listSessions();
+            result.discovered += sessions.length;
+            progress.phase('collect', `${adapter.displayName}: ${sessions.length} 个会话`);
+            const sessionFiles = new Map();
+            let n = 0;
+            for (const s of sessions) {
+                throwIfAborted(opts.signal);
+                n++;
+                sessionSeen.add(`${adapter.id}:${s.id}`);
+                if (cutoff && s.updatedAt < cutoff) {
+                    result.outOfWindow++;
+                    continue;
+                }
+                const relPath = `sessions/${s.id}.jsonl`;
+                sessionFiles.set(s.id, [relPath]);
+                const target = archivePath(vaultRoot, deviceId, adapter.id, relPath);
+                const exists = await fileExists(target);
+                const bucket = (state.sources[adapter.id] ??= {});
+                const entry = bucket[relPath];
+                if (entry &&
+                    entry.formatVersion === OPENCODE_EXPORT_VERSION &&
+                    entry.mtimeMs === s.updatedAt &&
+                    exists) {
+                    result.skipped++;
+                    continue;
+                }
+                const text = store.exportSession(s.id);
+                if (!text) {
+                    result.skipped++;
+                    continue;
+                }
+                const size = Buffer.byteLength(text);
+                // 内容没变(只是时间戳变了)→ 不重置世代、不重传
+                if (exists &&
+                    entry &&
+                    entry.size === size &&
+                    entry.prefixHash === hashBytes(Buffer.from(text))) {
+                    entry.mtimeMs = s.updatedAt;
+                    entry.sessionMtimeMs = s.updatedAt;
+                    entry.formatVersion = OPENCODE_EXPORT_VERSION;
+                    result.skipped++;
+                    continue;
+                }
+                const tmp = join(tmpDir, `opencode-${s.id}-${randomUUID()}.jsonl`);
+                try {
+                    await writeFile(tmp, text, 'utf8');
+                    const r = await archiveFile({
+                        sourcePath: tmp,
+                        targetPath: target,
+                        cursor: entry,
+                        srcStat: { size, mtimeMs: s.updatedAt },
+                        newGeneration: opts.newGeneration,
+                    });
+                    tally(result, r.action, r.bytesCopied);
+                    if (r.action !== 'skip')
+                        changedSessions.add(`${adapter.id}:${s.id}`);
+                    if (r.cursor) {
+                        bucket[relPath] = {
+                            ...r.cursor,
+                            sessionKey: s.id,
+                            sessionMtimeMs: s.updatedAt,
+                            formatVersion: OPENCODE_EXPORT_VERSION,
+                        };
+                    }
+                    progress.item(relPath, n, sessions.length, r.bytesCopied);
+                }
+                finally {
+                    await unlink(tmp).catch(() => { });
+                }
+            }
+        }
+        finally {
+            store.close();
+        }
+    }
+    result.sessions = sessionSeen.size;
+    result.changedSessions = [...changedSessions];
+    // raw 落盘后立即构建个人资产层(library);未变化的会话按签名跳过
+    await buildLibrary({ vaultRoot, deviceId, state });
+    return result;
+}
+/** 协作式中止:daemon 收到 SIGTERM 后不必等整轮跑完。 */
+export function throwIfAborted(signal) {
+    if (signal?.aborted)
+        throw new Error('已中止');
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function tally(r, action, bytes) {
+    if (action === 'skip') {
+        r.skipped++;
+        return;
+    }
+    r.bytesCopied += bytes;
+    if (action === 'append')
+        r.appended++;
+    else
+        r.archived++;
+}
+//# sourceMappingURL=collect.js.map

package/dist/core/collect.js.map

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

package/dist/core/concurrency.d.ts

@@ -0,0 +1,2 @@
+/** 有界并发 map;保持返回顺序与输入一致。 */
+export declare function mapLimit<T, R>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<R>): Promise<R[]>;

package/dist/core/concurrency.js

@@ -0,0 +1,16 @@
+/** 有界并发 map;保持返回顺序与输入一致。 */
+export async function mapLimit(items, limit, fn) {
+    const out = new Array(items.length);
+    let next = 0;
+    const workers = Array.from({ length: Math.max(1, Math.min(limit, items.length)) }, async () => {
+        for (;;) {
+            const i = next++;
+            if (i >= items.length)
+                return;
+            out[i] = await fn(items[i], i);
+        }
+    });
+    await Promise.all(workers);
+    return out;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/core/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/core/concurrency.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,KAAmB,EACnB,KAAa,EACb,EAA0C;IAE1C,MAAM,GAAG,GAAG,IAAI,KAAK,CAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE;QAC5F,SAAS,CAAC;YACR,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;YACjB,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YAC9B,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/cursor.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 游标变更判定(Beacon poll 骨架的核心语义,见 docs 调研 §游标三档)。
+ *
+ * 纯函数:只比较传入的元数据,不做 IO、不读时钟。
+ * 与 Beacon 的差异:trove 归档 raw 字节,故用「本地归档前缀哈希」替代行号,
+ * 从而在 append 前就能发现"文件被改写但 size 未回退"的情况。
+ */
+export interface FileCursor {
+    /** 已归档的字节数 */
+    size: number;
+    /** 上次看到的源文件 mtime(ms) */
+    mtimeMs: number;
+    /** 已归档字节的 sha256(十六进制);本地归档被删/损坏时无法匹配 */
+    prefixHash: string;
+    /** 归档世代:改写/重建时换新,远端旧世代保留(永不删除) */
+    generation: string;
+}
+export type FileAction = 'new' | 'skip' | 'append' | 'reset';
+/**
+ * 决定本轮对某源文件做什么:
+ *   - size + mtime 均未变   → skip(不读内容)
+ *   - 无游标              → new(全量归档)
+ *   - size 回退           → reset(截断/重建)
+ *   - size 相同但 mtime 变 → reset(就地改写,append 会把新旧内容混在一起)
+ *   - size 增长且前缀哈希一致 → append(只搬新增字节)
+ *   - 前缀哈希不一致       → reset(本地归档缺失或被改写)
+ */
+export declare function decideFileAction(cursor: FileCursor | undefined, src: {
+    size: number;
+    mtimeMs: number;
+}, archivedPrefixHash: string | null): FileAction;

package/dist/core/cursor.js

@@ -0,0 +1,31 @@
+/**
+ * 游标变更判定(Beacon poll 骨架的核心语义,见 docs 调研 §游标三档)。
+ *
+ * 纯函数:只比较传入的元数据,不做 IO、不读时钟。
+ * 与 Beacon 的差异:trove 归档 raw 字节,故用「本地归档前缀哈希」替代行号,
+ * 从而在 append 前就能发现"文件被改写但 size 未回退"的情况。
+ */
+/**
+ * 决定本轮对某源文件做什么:
+ *   - size + mtime 均未变   → skip(不读内容)
+ *   - 无游标              → new(全量归档)
+ *   - size 回退           → reset(截断/重建)
+ *   - size 相同但 mtime 变 → reset(就地改写,append 会把新旧内容混在一起)
+ *   - size 增长且前缀哈希一致 → append(只搬新增字节)
+ *   - 前缀哈希不一致       → reset(本地归档缺失或被改写)
+ */
+export function decideFileAction(cursor, src, archivedPrefixHash) {
+    if (!cursor)
+        return 'new';
+    // 本地归档缺失:即使源文件没变也必须重建(vault 被清理/损坏后的自愈)
+    if (archivedPrefixHash === null)
+        return 'reset';
+    if (src.size === cursor.size && src.mtimeMs === cursor.mtimeMs)
+        return 'skip';
+    if (src.size < cursor.size)
+        return 'reset';
+    if (src.size === cursor.size)
+        return 'reset';
+    return archivedPrefixHash === cursor.prefixHash ? 'append' : 'reset';
+}
+//# sourceMappingURL=cursor.js.map

package/dist/core/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/core/cursor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAA8B,EAC9B,GAAsC,EACtC,kBAAiC;IAEjC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,wCAAwC;IACxC,IAAI,kBAAkB,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAC9E,IAAI,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;QAAE,OAAO,OAAO,CAAC;IAC7C,OAAO,kBAAkB,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AACvE,CAAC"}

package/dist/core/events/claude.d.ts

@@ -0,0 +1,7 @@
+import type { Event, MapperFile } from './schema.js';
+export type { MapperFile } from './schema.js';
+/**
+ * Claude Code:一行一条记录,`message.content` 是字符串或内容块数组。
+ * 会话头取第一条消息的 sessionId/cwd/时间,首条 user 文本作为标题摘要。
+ */
+export declare function mapClaude(files: MapperFile[]): Event[];