@hongmaple0820/scale-engine 0.1.0

package/dist/artifact/types.d.ts

@@ -0,0 +1,333 @@
+/**
+ * SCALE Engine — Core Types
+ *
+ * 这是整个系统的"灵魂"。
+ * 所有 Artifact、Event、FSM 类型都在这里定义。
+ * 修改这个文件需要 W4 末的"数据模型冻结评审"通过。
+ *
+ * 设计参考：docs/02-DATA-MODEL.md
+ */
+/** 行为者：可以是 AI、人类或系统 */
+export type Actor = {
+    kind: 'ai';
+    role: string;
+    model?: string;
+} | {
+    kind: 'human';
+    userId: string;
+} | {
+    kind: 'system';
+    component: string;
+};
+/** 时间戳（毫秒） */
+export type Timestamp = number;
+/** 通用 ID 字符串。格式：{TYPE}-{YYYYMMDD}-{SEQ}，例如 SPEC-20260421-0007 */
+export type ArtifactId = string;
+export type EventId = string;
+export type SessionId = string;
+/** 11 种 Artifact 类型 */
+export type ArtifactType = 'Need' | 'Insight' | 'Spec' | 'Plan' | 'TestPlan' | 'Task' | 'Change' | 'Evidence' | 'Defect' | 'Lesson' | 'Release';
+export interface Artifact<TPayload = unknown> {
+    id: ArtifactId;
+    type: ArtifactType;
+    version: number;
+    status: string;
+    statusHistory: StatusChange[];
+    parents: ArtifactId[];
+    children: ArtifactId[];
+    supersedes?: ArtifactId;
+    title: string;
+    contentRef: string;
+    payload: TPayload;
+    gates: Gate[];
+    createdBy: Actor;
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+    closedAt?: Timestamp;
+    tags: string[];
+    labels: Record<string, string>;
+}
+export interface StatusChange {
+    from: string;
+    to: string;
+    at: Timestamp;
+    by: Actor;
+    reason?: string;
+    eventId: EventId;
+}
+export interface Gate {
+    name: string;
+    required: boolean;
+    threshold?: string;
+    actual?: unknown;
+    passed: boolean;
+    checkedAt?: Timestamp;
+    checkedBy?: Actor;
+}
+/** Need —— 用户原始诉求 */
+export interface NeedPayload {
+    rawText: string;
+    ambiguityScore?: number;
+    stakeholders: string[];
+}
+/** Insight —— 探索学习产出 */
+export interface InsightPayload {
+    category: 'fact' | 'constraint' | 'risk' | 'opportunity';
+    evidence: Array<{
+        type: 'file' | 'doc' | 'test' | 'log';
+        ref: string;
+    }>;
+    confidence: number;
+    contradictsArtifact?: ArtifactId;
+}
+/** Spec —— 需求契约 (WHAT) */
+export interface SpecPayload {
+    what: string;
+    successCriteria: string[];
+    outOfScope: string[];
+    edgeCases: string[];
+    northStar: string;
+}
+/** Plan —— 技术方案 (HOW) */
+export interface PlanPayload {
+    approach: string;
+    techChoices: Array<{
+        decision: string;
+        rationale: string;
+        alternatives: string[];
+    }>;
+    modules: Array<{
+        path: string;
+        action: 'create' | 'modify' | 'delete';
+        reason: string;
+    }>;
+    rollbackStrategy: string;
+    estimatedComplexity: number;
+}
+/** TestPlan —— 验证方案 */
+export interface TestPlanPayload {
+    unitTests: TestSpec[];
+    integrationTests: TestSpec[];
+    manualChecks: string[];
+    perfBudgets?: Array<{
+        metric: string;
+        target: string;
+    }>;
+}
+export interface TestSpec {
+    name: string;
+    given: string;
+    when: string;
+    then: string;
+    command?: string;
+}
+/** Task —— 原子可执行单元 */
+export interface TaskPayload {
+    description: string;
+    estimatedTokens?: number;
+    estimatedDurationMs?: number;
+    filesInvolved: string[];
+    dependsOn: ArtifactId[];
+    requiredRole: string;
+    requiredCapabilities: string[];
+}
+/** Change —— 实际代码变更 */
+export interface ChangePayload {
+    commitSha?: string;
+    prUrl?: string;
+    filesChanged: Array<{
+        path: string;
+        additions: number;
+        deletions: number;
+    }>;
+    diffSummary: string;
+    reverted?: boolean;
+}
+/** Evidence —— 验证证据 */
+export interface EvidencePayload {
+    testPlanId: ArtifactId;
+    toolUsed: string;
+    passed: boolean;
+    output: string;
+    duration: number;
+    artifacts: string[];
+}
+/** Defect —— 缺陷 */
+export interface DefectPayload {
+    symptom: string;
+    rootCauseCategory: 'requirement_ambiguity' | 'design_flaw' | 'implementation_bug' | 'test_gap' | 'environment_issue' | 'unknown';
+    rootCauseDetail: string;
+    fixChangeIds: ArtifactId[];
+    similarTo: ArtifactId[];
+    lesson?: ArtifactId;
+}
+/** Lesson —— 沉淀经验 */
+export interface LessonPayload {
+    type: 'lesson' | 'pattern' | 'best_practice' | 'anti_pattern' | 'decision' | 'troubleshooting' | 'workflow' | 'reference';
+    problem: string;
+    solution: string;
+    prevention: string;
+    sourceDefects: ArtifactId[];
+    applicableContexts: string[];
+    verified: boolean;
+    promotedToRule?: string;
+}
+/** Release —— 发布单 */
+export interface ReleasePayload {
+    version: string;
+    includesSpecs: ArtifactId[];
+    includesChanges: ArtifactId[];
+    rolloutStrategy: 'canary' | 'blue_green' | 'rolling' | 'all_at_once';
+    rolledBack?: boolean;
+    rollbackReason?: string;
+}
+/** 类型映射：根据 ArtifactType 推断 Payload 类型 */
+export type PayloadOf<T extends ArtifactType> = T extends 'Need' ? NeedPayload : T extends 'Insight' ? InsightPayload : T extends 'Spec' ? SpecPayload : T extends 'Plan' ? PlanPayload : T extends 'TestPlan' ? TestPlanPayload : T extends 'Task' ? TaskPayload : T extends 'Change' ? ChangePayload : T extends 'Evidence' ? EvidencePayload : T extends 'Defect' ? DefectPayload : T extends 'Lesson' ? LessonPayload : T extends 'Release' ? ReleasePayload : never;
+export type EventType = 'artifact.created' | 'artifact.updated' | 'artifact.transitioned' | 'artifact.gate_checked' | 'artifact.deleted' | 'tool.called' | 'tool.completed' | 'tool.failed' | 'tool.blocked' | 'gate.checked' | 'gate.passed' | 'gate.failed' | 'behavior.brute_retry' | 'behavior.idle_tool' | 'behavior.busy_loop' | 'behavior.premature_done' | 'behavior.blame_shift' | 'role.activated' | 'role.denied' | 'session.started' | 'session.ended' | 'session.compacted' | 'session.cleared' | 'lesson.proposed' | 'lesson.approved' | 'lesson.rejected' | 'lesson.recalled' | 'lesson.helpful' | 'lesson.useless' | 'task.scheduled' | 'task.started' | 'task.checkpointed' | 'task.paused' | 'task.resumed' | 'task.restored' | 'task.completed' | 'task.failed' | 'task.cancelled' | 'task.drift_detected' | 'task.step_started' | 'task.step_completed' | 'task.step_failed' | 'task.step_retrying' | 'task.decomposed' | `task.custom.${string}` | 'rule.proposed' | 'rule.enforced' | 'hook.generated' | 'evolution.cycle_completed' | 'context.built';
+export interface Event<TPayload = unknown> {
+    id: EventId;
+    type: EventType;
+    timestamp: Timestamp;
+    sessionId: SessionId;
+    actor: Actor;
+    artifactId?: ArtifactId;
+    payload: TPayload;
+    causedBy?: EventId;
+    correlationId?: string;
+}
+export interface FSMDefinition<S extends string = string, A extends string = string> {
+    type: ArtifactType;
+    states: readonly S[];
+    initial: S;
+    terminal: readonly S[];
+    transitions: ReadonlyArray<TransitionDef<S, A>>;
+}
+export interface TransitionDef<S extends string, A extends string> {
+    from: S;
+    action: A;
+    to: S;
+    guards?: Guard[];
+    effects?: Effect[];
+}
+export interface Guard {
+    name: string;
+    check: (artifact: Artifact, context: TransitionContext) => boolean | Promise<boolean>;
+    errorMessage: string;
+}
+export interface Effect {
+    name: string;
+    run: (artifact: Artifact, context: TransitionContext) => void | Promise<void>;
+}
+export interface TransitionContext {
+    actor: Actor;
+    reason?: string;
+    payload?: Record<string, unknown>;
+}
+export interface TransitionResult {
+    success: boolean;
+    artifact?: Artifact;
+    blockedBy?: GuardFailure[];
+    effectsExecuted: string[];
+}
+export interface GuardFailure {
+    guard: string;
+    message: string;
+}
+export interface Session {
+    id: SessionId;
+    agent: 'claude-code' | 'codex' | 'cursor' | 'gemini' | 'opencode' | 'unknown';
+    startedAt: Timestamp;
+    endedAt?: Timestamp;
+    activeRole?: string;
+    metadata: Record<string, unknown>;
+}
+export interface ToolUseInput {
+    sessionId: SessionId;
+    tool: string;
+    args: Record<string, unknown>;
+    timestamp?: Timestamp;
+}
+export interface ToolResultInput {
+    sessionId: SessionId;
+    tool: string;
+    args: Record<string, unknown>;
+    exitCode?: number;
+    output?: string;
+    duration?: number;
+    timestamp?: Timestamp;
+}
+export interface StopInput {
+    sessionId: SessionId;
+    aiOutput?: string;
+    projectType?: string;
+}
+export interface GateDecision {
+    allow: boolean;
+    reason?: string;
+    suggestion?: string;
+    injectContext?: string[];
+}
+export interface DetectorResult {
+    triggered: boolean;
+    severity?: 'warn' | 'block' | 'deny';
+    reason?: string;
+    suggestion?: string;
+}
+export interface KnowledgeEntry {
+    id: string;
+    type: LessonPayload['type'];
+    title: string;
+    tags: string[];
+    contentRef: string;
+    embeddingId?: string;
+    relevance: number;
+    accessCount: number;
+    lastAccessed?: Timestamp;
+    verified: boolean;
+    verifiedBy?: string;
+    verifiedAt?: Timestamp;
+    createdAt: Timestamp;
+    sourceArtifact?: ArtifactId;
+}
+export interface KnowledgeQuery {
+    type?: LessonPayload['type'] | LessonPayload['type'][];
+    tags?: string[];
+    minRelevance?: number;
+    verifiedOnly?: boolean;
+    limit?: number;
+}
+export interface RoleDefinition {
+    name: string;
+    canCreateArtifacts: ArtifactType[];
+    canModifyArtifacts?: Array<{
+        type: ArtifactType;
+        statuses: string[];
+    }>;
+    canReadArtifacts?: ArtifactType[];
+    allowedTools: string[];
+    deniedTools?: string[];
+    requiresUpstream?: Array<{
+        type: ArtifactType;
+        status?: string;
+        allMatch?: string;
+    }>;
+    mustRunAfterEdit?: string[];
+}
+export declare class ScaleError extends Error {
+    code: string;
+    details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+export declare class InvalidTransitionError extends ScaleError {
+    constructor(from: string, action: string);
+}
+export declare class GuardFailedError extends ScaleError {
+    failures: GuardFailure[];
+    constructor(failures: GuardFailure[]);
+}
+export declare class RoleDeniedError extends ScaleError {
+    constructor(role: string, reason: string);
+}
+export declare class ArtifactNotFoundError extends ScaleError {
+    constructor(id: string);
+}

package/dist/artifact/types.js

@@ -0,0 +1,50 @@
+/**
+ * SCALE Engine — Core Types
+ *
+ * 这是整个系统的"灵魂"。
+ * 所有 Artifact、Event、FSM 类型都在这里定义。
+ * 修改这个文件需要 W4 末的"数据模型冻结评审"通过。
+ *
+ * 设计参考：docs/02-DATA-MODEL.md
+ */
+// ============================================================================
+// 11. 错误类型
+// ============================================================================
+export class ScaleError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'ScaleError';
+    }
+}
+export class InvalidTransitionError extends ScaleError {
+    constructor(from, action) {
+        super(`State '${from}' does not support action '${action}'`, 'INVALID_TRANSITION', {
+            from,
+            action,
+        });
+    }
+}
+export class GuardFailedError extends ScaleError {
+    failures;
+    constructor(failures) {
+        super(`Transition blocked by guards: ${failures.map((f) => f.guard).join(', ')}`, 'GUARD_FAILED', {
+            failures,
+        });
+        this.failures = failures;
+    }
+}
+export class RoleDeniedError extends ScaleError {
+    constructor(role, reason) {
+        super(`Role '${role}' denied: ${reason}`, 'ROLE_DENIED', { role, reason });
+    }
+}
+export class ArtifactNotFoundError extends ScaleError {
+    constructor(id) {
+        super(`Artifact '${id}' not found`, 'ARTIFACT_NOT_FOUND', { id });
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/artifact/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/artifact/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgeH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,MAAM,OAAO,UAAW,SAAQ,KAAK;IACC;IAAqB;IAAzD,YAAY,OAAe,EAAS,IAAY,EAAS,OAAiB;QACxE,KAAK,CAAC,OAAO,CAAC,CAAA;QADoB,SAAI,GAAJ,IAAI,CAAQ;QAAS,YAAO,GAAP,OAAO,CAAU;QAExE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IACpD,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,UAAU,IAAI,8BAA8B,MAAM,GAAG,EAAE,oBAAoB,EAAE;YACjF,IAAI;YACJ,MAAM;SACP,CAAC,CAAA;IACJ,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAC3B;IAAnB,YAAmB,QAAwB;QACzC,KAAK,CAAC,iCAAiC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,cAAc,EAAE;YAChG,QAAQ;SACT,CAAC,CAAA;QAHe,aAAQ,GAAR,QAAQ,CAAgB;IAI3C,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CAAC,SAAS,IAAI,aAAa,MAAM,EAAE,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC5E,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACnD,YAAY,EAAU;QACpB,KAAK,CAAC,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;IACnE,CAAC;CACF"}

package/dist/context/ContextBuilder.d.ts

@@ -0,0 +1,36 @@
+import type { ArtifactId, SessionId } from '../artifact/types.js';
+import type { IArtifactStore } from '../artifact/store.js';
+import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
+import type { IEventBus } from '../core/eventBus.js';
+export interface ContextLayer {
+    name: string;
+    content: string;
+    priority: number;
+    estimatedTokens: number;
+}
+export interface BuiltContext {
+    system: string;
+    metadata: {
+        totalTokens: number;
+        layers: string[];
+    };
+}
+export interface IContextBuilder {
+    build(opts: {
+        roleId?: string;
+        currentArtifactId?: ArtifactId;
+        sessionId: SessionId;
+    }): Promise<BuiltContext>;
+}
+export declare class ContextBuilder implements IContextBuilder {
+    private store;
+    private kb;
+    private eventBus;
+    private budget;
+    constructor(store: IArtifactStore, kb: IKnowledgeBase, eventBus: IEventBus);
+    build(opts: {
+        roleId?: string;
+        currentArtifactId?: ArtifactId;
+        sessionId: SessionId;
+    }): Promise<BuiltContext>;
+}

package/dist/context/ContextBuilder.js

@@ -0,0 +1,53 @@
+// SCALE Engine — Context Builder (W6 完整实现)
+// 分层上下文加载 + Token 预算
+// 设计参考：docs/03-CORE-MODULES.md §3.6
+export class ContextBuilder {
+    store;
+    kb;
+    eventBus;
+    budget = { total: 200_000, reserved: 30_000 };
+    constructor(store, kb, eventBus) {
+        this.store = store;
+        this.kb = kb;
+        this.eventBus = eventBus;
+    }
+    async build(opts) {
+        const layers = [];
+        layers.push({ name: 'system_rules', content: '## SCALE Core Rules\n...', priority: 1, estimatedTokens: 3000 });
+        if (opts.roleId) {
+            layers.push({ name: 'role_prompt', content: `## Active Role: ${opts.roleId}\n...`, priority: 2, estimatedTokens: 1500 });
+        }
+        if (opts.currentArtifactId) {
+            const artifact = await this.store.get(opts.currentArtifactId);
+            if (artifact) {
+                layers.push({ name: 'current_artifact', content: `## ${artifact.title}\n${JSON.stringify(artifact.payload, null, 2)}`, priority: 3, estimatedTokens: 5000 });
+            }
+        }
+        // P5: 召回 lessons (W7 集成)
+        if (opts.currentArtifactId) {
+            const artifact = await this.store.get(opts.currentArtifactId);
+            if (artifact) {
+                const lessons = await this.kb.recallByVector(artifact.title, 3);
+                if (lessons.length > 0) {
+                    const content = '## 相关历史经验\n' + lessons.map((l) => `- ${l.title}`).join('\n');
+                    layers.push({ name: 'recalled_lessons', content, priority: 5, estimatedTokens: 1500 });
+                }
+            }
+        }
+        const available = this.budget.total - this.budget.reserved;
+        const selected = [];
+        let used = 0;
+        for (const layer of layers.sort((a, b) => a.priority - b.priority)) {
+            if (used + layer.estimatedTokens > available)
+                break;
+            selected.push(layer);
+            used += layer.estimatedTokens;
+        }
+        this.eventBus.emit('context.built', { layers: selected.map((l) => l.name), totalTokens: used }, { sessionId: opts.sessionId });
+        return {
+            system: selected.map((l) => l.content).join('\n\n---\n\n'),
+            metadata: { totalTokens: used, layers: selected.map((l) => l.name) },
+        };
+    }
+}
+//# sourceMappingURL=ContextBuilder.js.map

package/dist/context/ContextBuilder.js.map

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

package/dist/core/container.d.ts

@@ -0,0 +1,14 @@
+export type Token<T> = symbol & {
+    __type__?: T;
+};
+export declare function createToken<T>(name: string): Token<T>;
+export declare class Container {
+    private instances;
+    private factories;
+    register<T>(token: Token<T>, factory: () => T): void;
+    registerInstance<T>(token: Token<T>, instance: T): void;
+    resolve<T>(token: Token<T>): T;
+    has(token: symbol): boolean;
+    reset(): void;
+}
+export declare const container: Container;

package/dist/core/container.js

@@ -0,0 +1,33 @@
+// SCALE Engine — Dependency Injection
+// 极简 DI：避免循环依赖，方便测试时替换实现
+export function createToken(name) {
+    return Symbol(name);
+}
+export class Container {
+    instances = new Map();
+    factories = new Map();
+    register(token, factory) {
+        this.factories.set(token, factory);
+    }
+    registerInstance(token, instance) {
+        this.instances.set(token, instance);
+    }
+    resolve(token) {
+        if (this.instances.has(token))
+            return this.instances.get(token);
+        const factory = this.factories.get(token);
+        if (!factory)
+            throw new Error(`No registration for token: ${token.toString()}`);
+        const instance = factory();
+        this.instances.set(token, instance);
+        return instance;
+    }
+    has(token) {
+        return this.instances.has(token) || this.factories.has(token);
+    }
+    reset() {
+        this.instances.clear();
+    }
+}
+export const container = new Container();
+//# sourceMappingURL=container.js.map

package/dist/core/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/core/container.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,yBAAyB;AAIzB,MAAM,UAAU,WAAW,CAAI,IAAY;IACzC,OAAO,MAAM,CAAC,IAAI,CAAa,CAAA;AACjC,CAAC;AAED,MAAM,OAAO,SAAS;IACZ,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAA;IACtC,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAA;IAEpD,QAAQ,CAAI,KAAe,EAAE,OAAgB;QAC3C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACpC,CAAC;IAED,gBAAgB,CAAI,KAAe,EAAE,QAAW;QAC9C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACrC,CAAC;IAED,OAAO,CAAI,KAAe;QACxB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAM,CAAA;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACzC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QAC/E,MAAM,QAAQ,GAAG,OAAO,EAAO,CAAA;QAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACnC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,GAAG,CAAC,KAAa;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC/D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAA"}

package/dist/core/eventBus.d.ts

@@ -0,0 +1,60 @@
+import type { Event, EventType, EventId, Actor, ArtifactId, SessionId, Timestamp } from '../artifact/types.js';
+export type EventHandler<T = unknown> = (event: Event<T>) => void | Promise<void>;
+export interface Subscription {
+    unsubscribe(): void;
+}
+export interface EmitOptions {
+    sessionId?: SessionId;
+    actor?: Actor;
+    artifactId?: ArtifactId;
+    causedBy?: EventId;
+    correlationId?: string;
+}
+export interface ReplayFilter {
+    fromTimestamp?: Timestamp;
+    toTimestamp?: Timestamp;
+    types?: EventType[];
+    sessionId?: SessionId;
+    artifactId?: ArtifactId;
+}
+export interface QueryFilter extends ReplayFilter {
+    limit?: number;
+    filter?: (event: Event) => boolean;
+}
+export type EventMiddleware = (event: Event) => Event | null;
+export interface IEventBus {
+    on<T = unknown>(type: EventType | '*', handler: EventHandler<T>): Subscription;
+    once<T = unknown>(type: EventType, handler: EventHandler<T>): void;
+    emit<T = unknown>(type: EventType, payload: T, opts?: EmitOptions): Event<T>;
+    emitAsync<T = unknown>(type: EventType, payload: T, opts?: EmitOptions): Promise<Event<T>>;
+    use(middleware: EventMiddleware): void;
+    replay(filter: ReplayFilter, handler: EventHandler): Promise<void>;
+    query(filter: QueryFilter): Promise<Event[]>;
+    flush(): Promise<void>;
+}
+export declare class EventBus implements IEventBus {
+    private handlers;
+    private middlewares;
+    private memoryRing;
+    private maxRingSize;
+    private seq;
+    private eventsDir;
+    constructor(opts?: {
+        eventsDir?: string;
+    });
+    on<T>(type: EventType | '*', handler: EventHandler<T>): Subscription;
+    once<T>(type: EventType, handler: EventHandler<T>): void;
+    use(mw: EventMiddleware): void;
+    emit<T>(type: EventType, payload: T, opts?: EmitOptions): Event<T>;
+    emitAsync<T>(type: EventType, payload: T, opts?: EmitOptions): Promise<Event<T>>;
+    replay(filter: ReplayFilter, handler: EventHandler): Promise<void>;
+    query(filter: QueryFilter): Promise<Event[]>;
+    flush(): Promise<void>;
+    private generateId;
+    private persist;
+    private pushToRing;
+    private dispatchAsync;
+    private dispatchSync;
+    private getEventFiles;
+    private matchesFilter;
+}