@x-otto/service 0.0.1-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,617 @@
+import { Context, Hono } from "hono";
+import { TypedEventEmitter } from "@x-otto/shared";
+import { ProjectorState, SessionEvent, createProjectorState } from "@x-otto/session-contract";
+import { Devtools, PauseResumePayload } from "@x-otto/devtools";
+import { AgentSessionEvent, GrillAnswer, TraceEvent } from "@x-otto/agent";
+import { IncomingMessage, Server } from "node:http";
+import { StorageHost } from "@x-otto/persistence";
+import { AgentSession, ServiceHostPort } from "@x-otto/coding";
+import { Socket } from "node:net";
+
+//#region src/message-serializer.d.ts
+interface SerializedToolCall {
+  id: string;
+  name: string;
+  parameters: Record<string, unknown>;
+}
+interface SerializedMessage {
+  role: string;
+  content: string;
+  timestamp: number | undefined;
+  toolCalls: SerializedToolCall[];
+  /**
+   * RFC-210 D5（M4，评审 A5 REST 水合缺口修复）：消息 content 数组中的 a2ui block
+   * 组件树透传（此前 extractContent 只取 text block，a2ui 数据在历史水合路径丢失）。
+   * 无 a2ui block 时字段缺省（不占 wire 体积）。web-ui 水合层（message-hydration）按
+   * 此字段渲染 React catalog（M5）。
+   */
+  a2ui?: unknown[][];
+}
+//#endregion
+//#region src/types.d.ts
+type WebSocketMessage = {
+  type: 'Runtime.connected';
+  data: {
+    clientId: string;
+  };
+} | {
+  type: 'Runtime.pong';
+  data: {
+    timestamp: number;
+  };
+} | {
+  type: 'Runtime.error';
+  data: {
+    sessionId?: string;
+    message: string;
+    code?: string; /** RFC-335 S4：WRITE_LEASE_DENIED 之持有者客户端 id（拒绝反馈（非广播——同一 clientId 呈报） */
+    leaseOwner?: string;
+  };
+} | {
+  type: 'Runtime.writeLease';
+  data: {
+    sessionId: string;
+    state: 'acquired' | 'denied' | 'released' | 'not-held';
+    reason?: string; /** 当前持有者 clientId（acquired/denied/not-held 都为非空——语义否定据以下判定）；released 则为 undefined */
+    leaseOwner?: string;
+  };
+} | {
+  type: 'Session.event';
+  data: SessionEvent & {
+    seq?: number;
+  };
+} | {
+  type: 'Chat.nestedToolCall';
+  data: {
+    sessionId: string;
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+  };
+} | {
+  type: 'Chat.nestedToolResult';
+  data: {
+    sessionId: string;
+    id: string;
+    isError: boolean;
+  };
+} | {
+  type: 'Chat.planContent';
+  data: {
+    sessionId: string;
+    content: string;
+  };
+} | {
+  type: 'Chat.subagentStart';
+  data: {
+    sessionId: string;
+    agentName: string;
+  };
+} | {
+  type: 'Chat.subagentComplete';
+  data: {
+    sessionId: string;
+    agentName: string;
+  };
+} | {
+  type: 'Chat.parallelAgentsStart';
+  data: {
+    sessionId: string;
+    count: number;
+  };
+} | {
+  type: 'Chat.parallelAgentsDone';
+  data: {
+    sessionId: string;
+  };
+} | {
+  type: 'Chat.taskCompleted';
+  data: {
+    sessionId: string;
+    taskId: string;
+  };
+} | {
+  type: 'MCP.statusUpdate';
+  data: {
+    serverId: string;
+    status: string;
+  };
+} | {
+  type: 'MCP.serversUpdate';
+  data: {
+    servers: unknown[];
+  };
+} | {
+  type: 'Debugger.paused';
+  data: {
+    reason: string;
+    pauseId: string;
+    point?: unknown;
+    snapshot?: Record<string, unknown>;
+    timestamp: string;
+  };
+} | {
+  type: 'Debugger.resumed';
+  data: {
+    pauseId: string;
+    command?: unknown;
+    timestamp: string;
+  };
+} | {
+  type: 'Debugger.commandRejected';
+  data: {
+    code: string;
+    pauseId?: string;
+    command?: unknown;
+    timestamp: string;
+  };
+} | {
+  type: 'Debugger.breakpointsChanged';
+  data: {
+    breakpoints: unknown[];
+  };
+} | {
+  type: 'Log.entryAdded';
+  data: {
+    entry: LogEntryData;
+  };
+} | {
+  type: 'Trace.event';
+  data: {
+    sessionId: string;
+    seq: number;
+    event: TraceEvent;
+  };
+};
+interface LogEntryData {
+  id: number;
+  timestamp: string;
+  level: string;
+  module: string;
+  message: string;
+  data?: Record<string, unknown>;
+}
+/**
+ * 客户端发来的消息在传输层统一为此形式，data 字段在各 handler 中按协议解析。
+ * 具体各消息的 data shape 见 WebSocketClientData 类型映射。
+ */
+interface WebSocketClientMessage {
+  type: WebSocketClientMessageType;
+  data: Record<string, unknown>;
+}
+type WebSocketClientMessageType = 'Runtime.ping' | 'Chat.query' | 'Chat.approval' | 'Chat.askUserResponse' | 'Chat.planApprovalResponse' | 'Session.subscribe' | 'Session.unsubscribe' | 'Session.writeLease.acquire' | 'Session.writeLease.release' | 'Session.writeLease.force_acquire' | 'Debugger.resume' | 'Debugger.stepOver' | 'Debugger.stepInto' | 'Debugger.disable' | 'Debugger.setBreakpoint' | 'Debugger.setBreakpointsActive';
+interface ChatQueryData {
+  message: string;
+  sessionId?: string;
+}
+interface ChatApprovalData {
+  approvalId: string;
+  approved: boolean;
+  sessionId?: string;
+}
+interface ChatAskUserResponseData {
+  requestId: string;
+  answers: GrillAnswer | null;
+  cancelled?: boolean;
+  sessionId?: string;
+}
+interface ChatPlanApprovalResponseData {
+  requestId: string;
+  action: string;
+  feedback?: string;
+  sessionId?: string;
+}
+interface SessionSubscribeData {
+  sessionId: string;
+  /**
+   * RFC-335 M3：客户端已消费到的事件游标（取自 `SessionSnapshot.cursor`）。
+   * 服务端补发其后的事件再转实时流；缺省 = 只要实时流（旧客户端行为）。
+   */
+  since?: number;
+}
+interface DebuggerCommandData {
+  seq?: number;
+  pauseId?: string;
+  depth?: number;
+}
+interface DebuggerSetBreakpointData {
+  point: string;
+  enabled: boolean;
+}
+interface DebuggerSetBreakpointsActiveData {
+  active: boolean;
+}
+/**
+ * RFC-335 M1：服务实例的只读 Authority 身份。客户端只能以此描述符识别
+ * 唯一 Session Authority，不能据此构造或持有 AgentSession。
+ */
+interface AuthorityDescriptor {
+  /** 每个 CodingService 实例生命周期内稳定；进程/服务重启后必变。非鉴权 token。 */
+  instanceId: string;
+  /** authority 所属 workspace；客户端不得把它当作跨 workspace 路由许可。 */
+  workspaceDir: string;
+  /** 当前只声明快照与 session 事件订阅能力。cursor 原子接续在 RFC-335 M3 才引入。 */
+  protocolVersion: 1;
+  capabilities: readonly ('session.snapshot' | 'session.subscribe')[];
+}
+/** RFC-335 M1 的只读 session 水合 DTO。它不是与 WS 增量原子接续的 cursor；M3 解决该竞态。 */
+interface SessionSnapshot {
+  authority: AuthorityDescriptor;
+  session: {
+    id: string;
+    status: string;
+    messageCount: number; /** 与 `GET /api/sessions/:id/messages` 同一序列化契约（单一真源，消费方无需 assert）。 */
+    messages: SerializedMessage[];
+  };
+  /**
+   * RFC-335 M3：快照时刻的 `Session.event` 序列号。订阅时作为 `Session.subscribe.since`
+   * 传回，服务端据此补发期间事件，实现 snapshot→subscribe 无缝接续。
+   *
+   * 边界：只保证 `Session.event` 域；`Trace.event`/`Debugger.*` 不在其中（见
+   * `session-event-log.ts` 头注释）。
+   *
+   * 客户端 **MUST 按 `seq` 排序并去重**——补发走定向通道、实时流走订阅通道，
+   * 到达顺序不保证等于 seq 顺序。
+   */
+  cursor: number;
+  snapshotAt: string;
+}
+interface CodingServiceOptions {
+  host?: string;
+  port: number;
+  /** 测试/嵌入式宿主可注入稳定 identity；生产默认由服务实例生成。 */
+  authorityId?: string;
+  staticDir?: string;
+  cors?: string;
+  wsAuthToken?: string;
+  apiToken?: string;
+}
+interface IMessageSender {
+  broadcast(message: WebSocketMessage): void;
+  sendToSession(sessionId: string, message: WebSocketMessage): void;
+  sendToSubscribers(sessionId: string, message: WebSocketMessage): void;
+}
+//#endregion
+//#region src/session-event-log.d.ts
+/** 单条已编号事件。`seq` 在单个 session 内单调递增，从 1 开始。 */
+interface SequencedEvent {
+  seq: number;
+  message: WebSocketMessage;
+}
+type EventLogRead = /** 成功：`events` 是 cursor 之后的全部事件（可能为空，表示客户端已是最新）。 */{
+  ok: true;
+  events: SequencedEvent[];
+}
+/**
+ * 失败：请求的 cursor 已被环形缓冲逐出，无法补齐中间缺口。
+ * 调用方**必须**让客户端重新全量水合，不得降级为部分补发。
+ */
+| {
+  ok: false;
+  reason: 'gap';
+  oldestAvailable: number;
+};
+declare class SessionEventLog {
+  private readonly capacity;
+  private readonly buffers;
+  private readonly cursors;
+  constructor(capacity?: number);
+  /** 追加一条事件并返回其序列号。序列号由本方法唯一分配，调用方不得自行编号。 */
+  append(sessionId: string, message: WebSocketMessage): number;
+  /** 当前游标（= 已分配的最大序列号）。session 无事件时为 0。 */
+  cursorOf(sessionId: string): number;
+  /**
+   * 读取 `after` 之后的事件。
+   *
+   * `after === cursorOf()` → 成功且为空（客户端已最新）。
+   * `after` 早于缓冲区最旧一条 → `gap` 失败（中间已被逐出，无法诚实补齐）。
+   */
+  readFrom(sessionId: string, after: number): EventLogRead;
+  /** 会话结束/detach 时清理，避免 Map 无界增长。 */
+  clear(sessionId: string): void;
+}
+//#endregion
+//#region src/websocket-manager.d.ts
+interface WebSocketManagerEvents {
+  message: (clientId: string, message: WebSocketClientMessage) => void;
+}
+interface WebSocketManagerOptions {
+  allowedOrigins?: string[];
+  authToken?: string;
+  maxPayloadBytes?: number;
+  maxMessagesPerSecond?: number;
+  maxConnections?: number;
+}
+declare class WebSocketManager extends TypedEventEmitter<WebSocketManagerEvents> {
+  private readonly wss;
+  private readonly clients;
+  private readonly sessionSubscriptions;
+  private readonly options;
+  private readonly maxMessagesPerSecond;
+  private readonly maxConnections;
+  private clientId;
+  /** RFC-335 S4：client 断连触发点——InboundRouter 释放 write-lease。 */
+  onClientDisconnected?: (clientId: string) => void;
+  get clientCount(): number;
+  constructor(options?: WebSocketManagerOptions);
+  handleUpgrade(request: IncomingMessage, socket: Socket, head: Buffer, pathname: string): boolean;
+  private rejectUpgrade;
+  private isOriginAllowed;
+  private isTokenValid;
+  broadcast(message: WebSocketMessage): void;
+  sendToSession(sessionId: string, message: WebSocketMessage): void;
+  sendToSubscribers(sessionId: string, message: WebSocketMessage): void;
+  subscribeClient(clientId: string, sessionId: string): void;
+  unsubscribeClient(clientId: string, sessionId: string): void;
+  clearSessionSubscriptions(sessionId: string): void;
+  sendToClient(clientId: string, message: WebSocketMessage): void;
+  close(): void;
+  private onConnection;
+  private handleSystemClientMessage;
+  private handleRuntimePing;
+  private normalizeClientMessage;
+  private asRecord;
+}
+//#endregion
+//#region src/debug-bridge.d.ts
+interface DebugBridgeEvents {
+  'Debugger.paused': (data: Record<string, unknown>) => void;
+  'Debugger.resumed': (data: Record<string, unknown>) => void;
+  'Debugger.commandRejected': (data: Record<string, unknown>) => void;
+  'Log.entryAdded': (entry: LogEntryData) => void;
+}
+interface SendCommand {
+  type: string;
+  seq: number;
+  depth?: number;
+  [extra: string]: unknown;
+}
+declare class DebugBridge extends TypedEventEmitter<DebugBridgeEvents> {
+  private readonly devtools;
+  private readonly sender;
+  private logId;
+  private attached;
+  private readonly unsubs;
+  private readonly logs;
+  /**
+   * RFC-222 D3：`pauseId → sessionId` 映射——`Debugger.paused` 事件携带完整
+   * snapshot（`metadata.sessionId`），但 `Debugger.resumed`/`commandRejected`
+   * 只携带 `pauseId`/`command`，不重复携带 snapshot。记录映射使后两者也能按
+   * session 路由；`resumed` 触发后该 pauseId 已终结，随即清理避免无界增长。
+   */
+  private readonly pauseSessionMap;
+  constructor(devtools: Devtools, sender: IMessageSender);
+  attach(): void;
+  detach(): void;
+  /** snapshot.metadata.sessionId 提取（RFC-222 D3，缺省/非字符串时返回 undefined）。 */
+  private extractSessionId;
+  /** 进程内直连：attach 即可达（旧语义=worker WS socket 打开）。REST 端点据此判断可送达。 */
+  get isConnected(): boolean;
+  send(command: SendCommand, payload?: PauseResumePayload): void;
+  getLogs(): LogEntryData[];
+  /**
+   * RFC-222 D3：`sessionId` 已知时定向路由到该 session 的订阅者（`sendToSession`），
+   * 避免调试事件跨 session 泄漏；`sessionId` 未知（如 snapshot 未携带 metadata.sessionId
+   * 的历史/边缘调用点）时降级为 `broadcast`，不强行拆分导致事件丢失可见性。
+   */
+  private forwardDebugEvent;
+  private handleLogMessage;
+  private normalizeLevel;
+}
+//#endregion
+//#region src/coding-service.d.ts
+declare class CodingService {
+  readonly app: ServiceHostPort;
+  private readonly httpApp;
+  private readonly server;
+  private readonly host;
+  private readonly port;
+  private readonly staticDir?;
+  private readonly apiToken?;
+  private readonly wsAuthToken?;
+  /** RFC-335 M1：本 Authority 实例的非秘密身份；只用于 lifecycle state 与客户端重连判别。 */
+  private readonly authority;
+  /** RFC-335 M3：per-session 事件序列号 + 有界历史，支撑 snapshot→subscribe 无缝接续。 */
+  private readonly eventLog;
+  private readonly bridges;
+  private readonly traceBridges;
+  private readonly router;
+  private started;
+  readonly bridge: DebugBridge | null;
+  readonly ws: WebSocketManager;
+  get httpServer(): Server;
+  constructor(app: ServiceHostPort, options: CodingServiceOptions);
+  registerHooks(app: ServiceHostPort): void;
+  unregisterHooks(app: ServiceHostPort): void;
+  getSession(sessionId: string): AgentSession | undefined;
+  getActiveSession(): AgentSession | undefined;
+  /** RFC-335 M1：可序列化的唯一 session authority 描述符。 */
+  getAuthorityDescriptor(): AuthorityDescriptor;
+  /**
+   * RFC-335 M1/M3：只读水合快照，携带 `cursor`（拍摄快照时该 session 的事件序列号）。
+   *
+   * 客户端凭 `cursor` 订阅（`Session.subscribe` 带 `since`）即可获得**无缝接续**：
+   * 服务端先补发 cursor 之后的事件，再转实时流。若 cursor 已被环形缓冲逐出，服务端
+   * 会明确回报 gap 而非静默少发（见 `SessionEventLog`）。
+   */
+  getSessionSnapshot(sessionId: string): SessionSnapshot | undefined;
+  /** RFC-335 M3：读取 cursor 之后的事件（供 WS 订阅补发）。 */
+  readSessionEventsSince(sessionId: string, after: number): EventLogRead;
+  private readonly onUpgrade;
+  private readonly onWsMessage;
+  start(): Promise<void>;
+  stop(): Promise<void>;
+  attachSession(session: AgentSession): void;
+  detachSession(sessionId: string): void;
+  static(c: Context): Response;
+}
+declare function createCodingService(app: ServiceHostPort, options: CodingServiceOptions): CodingService;
+//#endregion
+//#region src/event-bridge.d.ts
+declare class EventBridge {
+  private readonly session;
+  private readonly sender;
+  /**
+   * 可选——供 `pulse-survey.show` 触发判定读取 `mars.getPulseSurveyConfig()`
+   * 与 `mars.isFeedbackAvailable()`。测试/未来其他消费方可不传（该判定分支静默跳过）。
+   */
+  private readonly app?;
+  private unsubscribeSession?;
+  /** per-session 投影累加器（delegated/todoList/turn）。 */
+  private projector;
+  /**
+   * RFC-209 §2.5：满意度脉冲调查触发状态（进程内存态，per-session，不持久化跨会话——
+   * 同 CLI 侧 `interactive-events.ts` 的 `pulseSurveyTriggerState` 语义，各自独立维护
+   * 互不干扰：TUI 与 web-ui 是两个并发客户端，各自的展示节奏不应互相耦合）。
+   */
+  private pulseSurveyState;
+  constructor(session: AgentSession, sender: IMessageSender,
+  /**
+   * 可选——供 `pulse-survey.show` 触发判定读取 `mars.getPulseSurveyConfig()`
+   * 与 `mars.isFeedbackAvailable()`。测试/未来其他消费方可不传（该判定分支静默跳过）。
+   */
+
+  app?: ServiceHostPort | undefined);
+  attach(): void;
+  /**
+   * RFC-210 D5（M4）：`tool.call.end` 之后的旁路编排（同 maybeSendPulseSurvey 模式，
+   * 不进 encodeSessionEvent 纯投影）——对该工具调用的结果消息跑插件 `a2ui.renderer`
+   * toPayload，命中则追加 `a2ui.payload` 事件下发。web-ui 经 React catalog 渲染（M5）。
+   * fail-soft：无 mars / 无插件命中 / toPayload 全部失败 → 静默跳过（默认渲染兜底）。
+   * async fire-and-forget：toPayload 有 2s 超时（ui-renderer-loader），不阻塞事件主流。
+   */
+  private maybeSendA2uiRendererPayload;
+  /**
+   * RFC-209 §2.5：`prompt.end` 之后的旁路编排——不是 `encodeSessionEvent` 投影产出的分支
+   * （该函数保持纯投影职责不变），而是本类在收到投影消息之后**额外**追加的判定+发送。
+   * Feedback 插件未装载时 `isFeedbackAvailable()` 为 false，静默跳过（fail-soft，同 §2.6）。
+   * web-ui 无 TUI 的 forced-upgrade Band A 硬模态概念，`forcedUpgradeActive` 恒 false。
+   */
+  private maybeSendPulseSurvey;
+  detach(): void;
+}
+//#endregion
+//#region src/inbound-router.d.ts
+declare class InboundRouter {
+  private readonly ws;
+  private readonly app;
+  private readonly bridge;
+  /**
+   * RFC-335 M3：按 cursor 读取待补发事件。以回调注入而非直接依赖 CodingService，
+   * 避免 router ↔ service 循环依赖（CodingService 已持有 router）。
+   * 未注入时 `since` 参数被忽略，退化为纯实时订阅（旧行为）。
+   */
+  private readonly readEventsSince?;
+  /** RFC-335 S4 协议面：session 写租约 per-session 单持有者裁决。仅由 dispatch 路径 mutation。 */
+  private readonly writeLease;
+  constructor(ws: WebSocketManager, app: ServiceHostPort, bridge: DebugBridge | null,
+  /**
+   * RFC-335 M3：按 cursor 读取待补发事件。以回调注入而非直接依赖 CodingService，
+   * 避免 router ↔ service 循环依赖（CodingService 已持有 router）。
+   * 未注入时 `since` 参数被忽略，退化为纯实时订阅（旧行为）。
+   */
+
+  readEventsSince?: ((sessionId: string, after: number) => EventLogRead) | undefined);
+  dispatch(clientId: string, message: WebSocketClientMessage): void;
+  /**
+   * RFC-335 M3：补发 `after` 之后的事件，衔接 snapshot 与实时流。
+   *
+   * 缺口（cursor 已被环形缓冲逐出）时**必须**显式告知客户端重新水合，绝不静默补发
+   * "能补的那部分"——那会让客户端以为序列完整，实则中间缺一段且永远无法察觉。
+   */
+  private replaySince;
+  private resolveSession;
+  /**
+   * RFC-222 D2：prompt 被拒绝（如并发 isBusy 守卫）时的错误必须**定向**发给触发本次
+   * 请求的客户端（`sendToClient`），不得广播给该 session 的全部订阅者（`sendToSession`）
+   * ——多端场景下正在正常执行中的其他客户端不应收到与自己无关的 "prompt failed"。
+   */
+  private handleQuery;
+  private handleApproval;
+  private handleAskUserResponse;
+  private handlePlanApprovalResponse;
+  private handleDebugCommand;
+  private handleDebugSetBreakpoint;
+  private handleDebugSetBreakpointsActive;
+}
+//#endregion
+//#region src/session-event-wire.d.ts
+/** 投影 + 脱敏 + 包装为 WS `Session.event`。projector 为调用方持有的 per-session 累加器。 */
+declare function encodeSessionEvent(event: AgentSessionEvent, projector: ProjectorState): WebSocketMessage[];
+//#endregion
+//#region src/persistenced-app.d.ts
+interface PersistencedOptions {
+  dir: string;
+  port?: number;
+  /** 必填，fail-closed。 */
+  token: string;
+  /** 默认 sessions；knowledge/archive namespace 已退场，memory=文件。 */
+  namespaces?: string[];
+  /** 默认 127.0.0.1；0.0.0.0 = 公网暴露。 */
+  host?: string;
+  /** 默认不启用 CORS。 */
+  corsOrigin?: string;
+  rateLimitRps?: number;
+  maxBodyBytes?: number;
+}
+/** persistenced 服务默认监听端口——族内单源（cli/persistenced.ts 复用，消除双源漂移）。 */
+declare const PERSISTENCED_DEFAULT_PORT = 3001;
+/**
+ * 启动 persistenced 独立服务。
+ *
+ * 返回 { app, server, host: StorageHost } 供测试注入/优雅退出。
+ */
+declare function startPersistenced(options: PersistencedOptions): Promise<{
+  app: Hono;
+  server: Server;
+  host: StorageHost;
+  url: string;
+}>;
+//#endregion
+//#region src/event-bus.d.ts
+/**
+ * 进程内事件总线（M29-04-01）。
+ *
+ * SSE 路由和 storage append 路由共享此实例：
+ *   - SSE: `eventBus.on(topic, cb)` 订阅 append 事件 → SSE push
+ *   - Storage: `eventBus.emit(event)` 发布 append 事件 → 广播给所有 SSE 订阅者
+ *
+ * 设计决策：模块级单例而非 CodingService 成员——
+ * 两个独立路由（events.ts 和 storage.ts）都需要访问同一实例，
+ * 单例避免了通过 CodingService 传参的耦合。
+ */
+interface AppendEvent {
+  /** topic，如 'sessions'。 */
+  namespace: string;
+  /**
+   * workspace 分区键。SSE live-push 据此按订阅者 wsKey 过滤——缺省(legacy/单租户)
+   * 不携带则订阅者收全量。多租户下 emit 必带，订阅者按 wsKey 隔离（防 B12 跨 workspace 泄漏）。
+   */
+  wsKey?: string;
+  docId: string;
+  entry: unknown;
+  /** Unix ms。 */
+  ts: number;
+}
+type Unsubscribe = () => void;
+declare class EventBus {
+  private listeners;
+  /**
+   * 订阅某个 namespace 的 append 事件。
+   * @returns 取消订阅函数。
+   */
+  on(namespace: string, callback: (event: AppendEvent) => void): Unsubscribe;
+  /**
+   * 发布 append 事件到所有订阅了对应 namespace 的监听器。
+   * 单个监听器异常不影响其他监听器。
+   */
+  emit(event: AppendEvent): void;
+  /** 仅测试使用。 */
+  reset(): void;
+  /** 调试/测试用。 */
+  get listenerCount(): number;
+}
+declare const eventBus: EventBus;
+//#endregion
+export { type AppendEvent, type AuthorityDescriptor, type ChatApprovalData, type ChatAskUserResponseData, type ChatPlanApprovalResponseData, type ChatQueryData, CodingService, type CodingServiceOptions, DebugBridge, type DebuggerCommandData, type DebuggerSetBreakpointData, type DebuggerSetBreakpointsActiveData, EventBridge, EventBus, type EventLogRead, type IMessageSender, InboundRouter, type LogEntryData, PERSISTENCED_DEFAULT_PORT, type PersistencedOptions, type ProjectorState, type SequencedEvent, type SerializedMessage, type SerializedToolCall, SessionEventLog, type SessionSnapshot, type SessionSubscribeData, type Unsubscribe, type WebSocketClientMessage, type WebSocketClientMessageType, WebSocketManager, type WebSocketMessage, createCodingService, createProjectorState, encodeSessionEvent, eventBus, startPersistenced };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/message-serializer.ts","../src/types.ts","../src/session-event-log.ts","../src/websocket-manager.ts","../src/debug-bridge.ts","../src/coding-service.ts","../src/event-bridge.ts","../src/inbound-router.ts","../src/session-event-wire.ts","../src/persistenced-app.ts","../src/event-bus.ts"],"mappings":"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"}