mycohive-claw 4.0.0

package/dist/event-bus.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Event Bus 模块
+ * 版本: v4.0.0
+ *
+ * 发布-订阅事件驱动通信机制。
+ * 支持 OpenClaw 原生事件和自定义事件。
+ * 优化：使用前缀树(Trie)加速订阅匹配，DLQ 重试+告警机制
+ */
+export declare enum EventType {
+    TASK_CREATED = "task.created",
+    TASK_STARTED = "task.started",
+    TASK_COMPLETED = "task.completed",
+    TASK_FAILED = "task.failed",
+    TASK_CANCELLED = "task.cancelled",
+    STEP_COMPLETED = "step.completed",
+    STEP_FAILED = "step.failed",
+    TOPIC_CREATED = "topic.created",
+    TOPIC_CLOSED = "topic.closed",
+    AGENT_MESSAGE = "agent.message",
+    AGENT_DISPATCH = "agent.dispatch",
+    ROUTER_ANALYSIS = "router.analysis",
+    ROUTER_DISPATCH = "router.dispatch",
+    ITERATE_ROUND_DONE = "iterate.round_done",
+    SYSTEM_READY = "system.ready",
+    SYSTEM_ERROR = "system.error",
+    SESSION_CREATED = "session.created",
+    SESSION_ACTIVATED = "session.activated",// Session 变为活跃
+    SESSION_IDLE = "session.idle",// Session 变为空闲
+    SESSION_ENDED = "session.ended",
+    SESSION_ERROR = "session.error",// Session 出错
+    FRONT_MESSAGE_RECEIVED = "front.message_received",// 入口层消息接收（载荷: {session_id, content}）
+    MESSAGE_RECEIVED = "message.received",
+    MESSAGE_SENT = "message.sent",
+    MESSAGE_FAILED = "message.failed",
+    MESSAGE_ROUTED = "message.routed",
+    ROUTING_STARTED = "routing.started",
+    ROUTING_COMPLETED = "routing.completed",
+    ROUTING_FAILED = "routing.failed"
+}
+export interface Event {
+    id: string;
+    type: string;
+    source: string;
+    data: Record<string, unknown>;
+    timestamp: number;
+    parent_id?: string;
+    correlation_id?: string;
+    session_key?: string;
+}
+export type EventHandler = (event: Event) => void | Promise<void>;
+export type AsyncEventHandler = (event: Event) => void | Promise<void>;
+export declare class EventBus {
+    private subscriptions;
+    private eventHistory;
+    private maxHistory;
+    private maxAge;
+    private storagePath;
+    private dlqPath;
+    private cleanupTimer;
+    private dlqRetryTimer;
+    private dlqAlertThreshold;
+    private dlqRetryDelayMs;
+    private maxDlqRetries;
+    private subscriptionTrie;
+    private hasWildcard;
+    private hasPatternSubs;
+    constructor(options?: {
+        storagePath?: string;
+        dlqPath?: string;
+        maxHistory?: number;
+        maxAge?: number;
+        dlqAlertThreshold?: number;
+        dlqRetryDelayMs?: number;
+        maxDlqRetries?: number;
+    });
+    /**
+     * 启动定期清理定时器
+     */
+    private startCleanupTimer;
+    /**
+     * 启动 DLQ 重试定时器
+     */
+    private startDlqRetryTimer;
+    /**
+     * 计算指数退避延迟
+     */
+    private calculateDlqBackoff;
+    /**
+     * 处理 DLQ 重试
+     */
+    private processDlqRetries;
+    /**
+     * DLQ 告警（可被外部覆盖）
+     */
+    private emitDlqAlert;
+    /**
+     * 清理过期事件，防止内存泄漏
+     */
+    cleanup(): number;
+    /**
+     * 停止清理定时器和 DLQ 重试
+     */
+    dispose(): void;
+    private loadHistory;
+    private saveHistory;
+    private generateId;
+    private publishDLQ;
+    /**
+     * 将事件类型插入前缀树
+     */
+    private insertIntoTrie;
+    /**
+     * 从前缀树移除订阅
+     */
+    private removeFromTrie;
+    subscribe(eventType: string, handler: EventHandler): () => void;
+    subscribeAsync(eventType: string, handler: AsyncEventHandler): () => void;
+    unsubscribe(eventType: string, handler: EventHandler): void;
+    publish(event: Event, persist?: boolean): void;
+    /**
+     * 检查 handler 是否应该接受某个 session 的事件
+     * 通过检查订阅时的 eventType 是否包含 session 信息来简单判断
+     * 实际生产中建议在订阅时显式注册 session-scoped handlers
+     */
+    private handlerAcceptsSession;
+    publishAsync(event: Event, persist?: boolean): Promise<void>;
+    /**
+     * 优化的订阅匹配（使用前缀树 + 缓存）
+     */
+    private getMatchingHandlers;
+    /**
+     * 从前缀树收集匹配的处理者
+     * 支持通配符 "*" 子节点回溯匹配
+     */
+    private collectMatchingHandlersFromTrie;
+    /**
+     * 检查事件类型是否匹配模式（如 "task.*" 匹配 "task.created"）
+     */
+    private matchPattern;
+    /**
+     * 统一提取 session_key 的方法
+     */
+    private extractSessionKey;
+    getHistory(eventType?: string, limit?: number): Event[];
+    /**
+     * 获取特定 session 的事件历史
+     */
+    getHistoryBySession(sessionKey: string, limit?: number): Event[];
+    /**
+     * 获取所有活跃 session（最近有事件的 session）
+     */
+    getActiveSessions(): string[];
+    clearHistory(): void;
+    emitTaskCreated(taskId: string, agent: string, extra?: Record<string, unknown>): void;
+    emitTaskCompleted(taskId: string, result?: unknown, extra?: Record<string, unknown>): void;
+    emitTaskFailed(taskId: string, error: string, extra?: Record<string, unknown>): void;
+    emitAgentDispatch(from: string, to: string, taskId: string, extra?: Record<string, unknown>): void;
+    emitRouterAnalysis(userMessage: string, intent: Record<string, unknown>, confidence: number, extra?: Record<string, unknown>): void;
+    emitIterateRoundDone(taskId: string, verdict: "PASS" | "FAIL" | "RETRY", extra?: Record<string, unknown>): void;
+    emitSessionActivated(sessionKey: string, extra?: Record<string, unknown>): void;
+    emitSessionIdle(sessionKey: string, extra?: Record<string, unknown>): void;
+    emitSessionError(sessionKey: string, error: string, extra?: Record<string, unknown>): void;
+    emitFrontMessageReceived(sessionId: string, content: string, extra?: Record<string, unknown>): void;
+    emitMessageReceived(sessionKey: string, message: string, extra?: Record<string, unknown>): void;
+    emitMessageSent(sessionKey: string, message: string, extra?: Record<string, unknown>): void;
+    emitMessageRouted(sessionKey: string, routedTo: string[], extra?: Record<string, unknown>): void;
+    emitRoutingStarted(sessionKey: string, message: string, extra?: Record<string, unknown>): void;
+    emitRoutingCompleted(sessionKey: string, intent: Record<string, unknown>, extra?: Record<string, unknown>): void;
+    emitRoutingFailed(sessionKey: string, error: string, extra?: Record<string, unknown>): void;
+    emitRouterDispatched(sessionId: string, plan: Record<string, unknown>, extra?: Record<string, unknown>): void;
+}
+export declare function getEventBus(): EventBus;
+export declare function setEventBus(bus: EventBus): void;
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

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