openclaw-openagent 1.0.0

package/src/transport/types.ts

@@ -0,0 +1,541 @@
+/**
+ * Transport 接口定义层 —— OASN/TIM 双轨抽象的"零依赖"基础
+ *
+ * 设计依据：docs/specs/2026-06-16-oasn-transport-abstraction-design.md §2.1
+ *
+ * 设计原则（Interface Segregation Principle）：
+ *   把原本"塞在一个 AgentTransport 接口里"的所有能力拆成 6 个能力接口，
+ *   再用 TypeScript intersection type 组合出 OasnTransport / TimTransport，
+ *   联合为 AgentTransport。上层代码依赖最小能力集即可，不再需要
+ *   `transport.foo?.()` 防御式调用 —— 类型系统在编译期就保证调用合法性。
+ *
+ * 能力 ↔ 实现 矩阵：
+ *
+ *   能力接口             ┃ OasnTransport ┃ TimTransport
+ *   ─────────────────────┃───────────────┃─────────────
+ *   CoreTransport        ┃      ✓        ┃      ✓
+ *   TaskTransport        ┃      ✓        ┃      ✓
+ *   DiscoveryTransport   ┃      ✓        ┃      ✓
+ *   RegistrationTransport┃      ✓        ┃      ✗
+ *   FileTransport        ┃      ✓        ┃      ✗
+ *   IMChannelTransport   ┃      ✗        ┃      ✓
+ */
+
+// ═══════════════════════════════════════════════════════════════
+// 凭证层
+// ═══════════════════════════════════════════════════════════════
+
+/**
+ * 通用传输凭证。两种 transport 在不同字段语义下复用同一结构。
+ *
+ *   字段        ┃ OASN                      ┃ TIM
+ *   ────────────┃───────────────────────────┃────────────────────────
+ *   identity    ┃ agent_id (`agt_cli_*`)    ┃ userId（= agentId）
+ *   token       ┃ api_key (`oak_*`) Bearer   ┃ userSig
+ *   expiresAt   ┃ 0（api_key 不过期）        ┃ epoch ms（含 5min margin）
+ *
+ * 注：实现相关常量（apiBase / sdkAppId 等）属于"transport 构造参数"，
+ * 不进入凭证结构，避免运行期 Record<string, unknown> 类型逃逸。
+ */
+export interface TransportCredentials {
+  /** OASN: agent_id；TIM: userId */
+  identity: string;
+  /** OASN: api_key (Bearer)；TIM: userSig */
+  token: string;
+  /** 过期时间戳 (epoch ms)。OASN 静态 api_key = 0 */
+  expiresAt: number;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// 任务请求 / 结果
+// ═══════════════════════════════════════════════════════════════
+
+/**
+ * 发起一次远程 Agent 调用的入参。
+ *
+ *   - OASN 路径：requestId 仅做客户端 trace；服务端用 idempotency_key + invocation_id 标识调用
+ *   - TIM  路径：requestId 直接作为 C2C 关联 id
+ */
+export interface TaskRequest {
+  /** 客户端生成的请求 id（不等同于 OASN 的 invocation_id） */
+  requestId: string;
+  /** 任务文本内容 —— LLM 工具的 `task` 参数 */
+  task: string;
+  /**
+   * 续传已有 session 时填入。
+   *   - OASN: 用于在已有 session 上叠加新 Invocation
+   *   - TIM:  C2C 无 session 概念，传入即忽略
+   */
+  sessionId?: string;
+  /** 附件引用列表（OASN file_ref；TIM 当前不支持，忽略） */
+  inputFileRefs?: string[];
+  /** Artifact 引用列表（OASN-only） */
+  inputArtifactRefs?: string[];
+  /** OASN Invocation 期望执行超时；服务端会裁决为 effective_timeout_ms */
+  timeoutMs?: number;
+}
+
+/** 进度回调载荷 */
+export interface TaskProgress {
+  requestId: string;
+  /**
+   * 进度文本。
+   *   - OASN: progress.safe_status_message
+   *   - TIM:  C2C `openagent_task_progress` 自定义消息中的 content
+   */
+  content: string;
+}
+
+/**
+ * Artifact 引用 —— 远程 Agent 返回的产物（文件/二进制）。
+ * 上层若需要内容，必须再次调用 `FileTransport.downloadArtifact()` 拉取。
+ */
+export interface ArtifactRef {
+  id: string;
+  displayName: string;
+  mimeType: string;
+  sizeBytes: number;
+  /** 服务端是否已就绪可下载。OASN 来自 artifacts[].content_available */
+  contentAvailable: boolean;
+  /**
+   * 内容拉取地址。
+   *   - OASN: `${apiBase}/api/artifacts/{id}/content`（需 Bearer api_key）
+   *   - TIM:  TIM 服务下载 URL（fetch 即得）
+   */
+  contentUrl: string;
+}
+
+/** 任务结果 */
+export interface TaskResult {
+  requestId: string;
+  status: 'complete' | 'error';
+  /**
+   * 文本结果。
+   *   - OASN: inline_result.summary
+   *   - TIM:  C2C `openagent_task_result.content`
+   */
+  content: string;
+  /** 产物列表。可能为空 */
+  artifacts?: ArtifactRef[];
+}
+
+/**
+ * `sendTask` 返回值。携带可观察性 id，便于上层 trace + idempotency 续轮询。
+ *
+ *   - OASN: 含 invocation_id / session_id / effective_timeout_ms
+ *   - TIM:  invocationId = requestId（C2C 无独立 invocation）；其他字段 undefined
+ */
+export interface TaskHandle {
+  /** OASN: invocation_id；TIM: requestId */
+  invocationId: string;
+  /** OASN: session_id；TIM: undefined */
+  sessionId?: string;
+  /** 服务端裁决后的实际超时（OASN: effective_timeout_ms） */
+  effectiveTimeoutMs?: number;
+  /** 服务端首轮建议轮询间隔（OASN: next_poll_after_ms） */
+  nextPollAfterMs?: number;
+}
+
+/** 进度回调签名 */
+export type ProgressCallback = (progress: TaskProgress) => void;
+
+/** 被调端任务处理器签名（OASN 不会触发，仅 TIM 的 T3 路径使用） */
+export type TaskHandler = (request: TaskRequest & { from: string }) => Promise<TaskResult>;
+
+// ═══════════════════════════════════════════════════════════════
+// 错误类型
+// ═══════════════════════════════════════════════════════════════
+
+/**
+ * 传输层统一错误。HTTP 错误 / SDK 错误都在 transport 内部转换为此类型。
+ *
+ *   - OASN 来源：响应体 `error.{ code, message, retryable, details, request_id }`
+ *   - TIM  来源：SDK 错误 code（KICKED_OUT / NETWORK_TIMEOUT / ...）
+ */
+export interface TransportError extends Error {
+  /** 原始错误码 */
+  code: string;
+  /** 是否可重试（OASN 服务端裁决，TIM 由本地判断） */
+  retryable: boolean;
+  /** OASN: error.request_id；TIM: SDK request id（若有） */
+  requestId?: string;
+  /** 关联 invocation/session（如有） */
+  invocationId?: string;
+  sessionId?: string;
+}
+
+/**
+ * 构造 TransportError 的工厂。各 transport 实现内部调用。
+ * 此处显式声明为 function 而非 class，因为 TransportError 是接口而非具体类型。
+ */
+export function makeTransportError(
+  code: string,
+  message: string,
+  opts: { retryable?: boolean; requestId?: string; invocationId?: string; sessionId?: string } = {},
+): TransportError {
+  const err = new Error(message) as TransportError;
+  err.code = code;
+  err.retryable = opts.retryable ?? false;
+  if (opts.requestId) err.requestId = opts.requestId;
+  if (opts.invocationId) err.invocationId = opts.invocationId;
+  if (opts.sessionId) err.sessionId = opts.sessionId;
+  return err;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// Agent 发现 —— AgentCard / 搜索
+// ═══════════════════════════════════════════════════════════════
+
+/**
+ * OASN AgentCard 公开视图。
+ * 与 OASN apis.md `GET /api/agent-cards/{agent_id}` 响应字段一一对齐。
+ */
+export interface AgentCard {
+  agent_id: string;
+  agent_type: 'client' | 'service';
+  name: string;
+  description: string | null;
+  /** Model Operation Manual —— 使用说明（Markdown） */
+  MOM: string | null;
+  tags: Array<{ tag_id: string; name: string }>;
+  category: string[];
+  avatar_url: string | null;
+  visibility?: 'public' | 'private';
+}
+
+/** 搜索请求。三种搜索模式（by-query / by-category / by-tags）共用同一结构，由非空字段判定走哪个端点 */
+export interface SearchQuery {
+  /** 自然语言（`by-query`） */
+  query?: string;
+  /** category id 数组（`by-category`） */
+  category?: string[];
+  /** tag id 数组（`by-tags`） */
+  tags?: string[];
+  /** 默认 `["service"]`。当前 OASN search 只支持 service */
+  agentTypes?: string[];
+  sort?: Array<'relevance' | 'usage' | 'recency'>;
+  pageSize?: number;
+  pageNum?: number;
+}
+
+export interface SearchResult {
+  searchId: string;
+  agentCards: AgentCard[];
+  pageNum: number;
+  pageSize: number;
+  hasNext: boolean;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// 注册 / 认领 / Owner（OASN-only）
+// ═══════════════════════════════════════════════════════════════
+
+/** `POST /api/agents/register` 响应 */
+export interface RegisterResult {
+  agent_id: string;
+  agent_type: 'client';
+  /** 一次性明文 api_key —— 持久化后必须立即从内存清理 */
+  api_key: string;
+  claim_url: string;
+  status: 'unclaimed';
+  agent_card: AgentCard;
+}
+
+/** `POST /api/agents/claim` 请求 */
+export interface ClaimParams {
+  agent_id?: string;
+  /** 来自 claim_url 末段（与 agent_id+api_key 二选一） */
+  claim_token?: string;
+  owner_email: string;
+}
+
+export interface ClaimResult {
+  agent_id: string;
+  status: 'claim_email_sent';
+  owner_email_masked: string;
+  /** 邮件验证链接过期时间（ISO 8601 字符串） */
+  expires_at: string;
+}
+
+/** `GET /api/agents/{agent_id}` 响应 */
+export interface AgentStatusResult {
+  agent_id: string;
+  status: 'unclaimed' | 'claim_pending' | 'claimed';
+  /** CA/ClientAgent access token, not Owner token. Runtime-only. */
+  access_token?: string;
+}
+
+/** `PATCH /api/agent-cards/{agent_id}` 请求。PATCH 语义：省略=不变，显式 null=清空 */
+export interface AgentCardPatch {
+  name?: string | null;
+  description?: string | null;
+  MOM?: string | null;
+  tags?: string[] | null;
+  category?: string[] | null;
+  avatar_ref?: string | null;
+  visibility?: 'public' | 'private';
+  public_metadata?: Record<string, unknown> | null;
+}
+
+/** Category 树节点 */
+export interface CategoryNode {
+  category_id: string;
+  name: string;
+  children?: CategoryNode[];
+}
+
+export interface CategoryTree {
+  categories: CategoryNode[];
+  updated_at: string;
+}
+
+/** `GET /api/users/me` 响应（Owner 维度，插件当前主要走 Agent api_key） */
+export interface OwnerInfo {
+  owner_id: string;
+  owner_type: string;
+  display_name: string;
+  email_masked: string;
+  email_verified_at?: string;
+  status: string;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// 文件 / Artifact（OASN-only）
+// ═══════════════════════════════════════════════════════════════
+
+/** `POST /api/files` 输入参数 */
+export interface UploadFileParams {
+  /** 文件内容（浏览器 Blob 或 Node Buffer） */
+  content: Blob | Buffer;
+  /** 展示名（含后缀） */
+  displayName: string;
+  /** 用途标签：input / reference / ... */
+  purpose?: string;
+  /** 期望可引用时长（秒），服务端最终裁决 */
+  expiresInSeconds?: number;
+  /** MIME 类型（可选，未传时服务端推断） */
+  mimeType?: string;
+}
+
+/** `POST /api/files` 响应 */
+export interface UploadFileResult {
+  /** 后续 Invocation 的 input_file_refs 使用 */
+  fileRef: string;
+  displayName: string;
+  mimeType: string;
+  sizeBytes: number;
+  /** epoch ms */
+  expiresAt: number;
+}
+
+/** Artifact 下载结果 */
+export interface DownloadArtifactResult {
+  content: ArrayBuffer;
+  mimeType: string;
+  displayName: string;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// IM 频道（TIM-only，多数当前 DORMANT）
+// ═══════════════════════════════════════════════════════════════
+
+export interface ChannelInfo {
+  id: string;
+  name: string;
+  desc: string;
+  memberCount?: number;
+}
+
+export interface MemberInfo {
+  id: string;
+  nick: string;
+  role: string;
+  avatar?: string;
+}
+
+/** 群聊文本消息（TIM-only） */
+export interface TransportMessage {
+  id: string;
+  channelId: string;
+  from: string;
+  nick: string;
+  text: string;
+  /** epoch ms（注：TIM 原始为秒，转换由 transport 层完成） */
+  time: number;
+  mentionsMe: boolean;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// 事件类型
+// ═══════════════════════════════════════════════════════════════
+
+/** 两种 transport 都会触发的核心事件 */
+export type CoreTransportEvent =
+  /** 凭证失效。OASN: 401 UNAUTHENTICATED；TIM: KICKED_OUT */
+  | 'credential_expired'
+  /** 重连成功（TIM 有意义；OASN 通常不触发） */
+  | 'reconnected'
+  /** 连接断开（TIM 有意义；OASN 通常不触发） */
+  | 'disconnected';
+
+/** 仅 TIM transport 会触发的事件 */
+export type TimOnlyTransportEvent =
+  /** 群聊消息到达 */
+  | 'message'
+  /** 收到远程 agent 的 C2C 任务请求（T3 路径） */
+  | 'task_received'
+  /** 任务进度推送（C2C 接收方） */
+  | 'task_progress';
+
+export type TransportEvent = CoreTransportEvent | TimOnlyTransportEvent;
+
+// ═══════════════════════════════════════════════════════════════
+// 能力接口
+// ═══════════════════════════════════════════════════════════════
+
+/**
+ * 核心生命周期 —— 两种 transport 都实现。
+ *
+ *  `ready / isReady` 语义统一为"凭证已校验，可工作"：
+ *   - OASN: api_key 通过 GET /api/agent-cards/{agent_id} 验证
+ *   - TIM:  WS 已 login 且 SDK_READY
+ */
+export interface CoreTransport {
+  /** 实例 id（多账户支持时用作 key） */
+  readonly id: string;
+  readonly transportType: 'oasn' | 'tim';
+
+  /** 校验凭证并进入可工作状态 */
+  ready(credentials: TransportCredentials): Promise<void>;
+
+  /** 释放资源（OASN: 清轮询 timer；TIM: WS logout） */
+  dispose(): Promise<void>;
+
+  /** 是否处于可工作状态 */
+  readonly isReady: boolean;
+
+  on(event: CoreTransportEvent, handler: (...args: any[]) => void): void;
+  off(event: CoreTransportEvent, handler: (...args: any[]) => void): void;
+}
+
+/**
+ * 任务调用（T2 主路径）—— 两种 transport 都实现。
+ *
+ * 注意：返回的 `TaskHandle` 由调用方持有并传给 `waitForTaskResult`。
+ * 上层不要假设它是简单的 string id —— OASN 需要 invocation_id + session_id 联动。
+ */
+export interface TaskTransport {
+  /** 发起远程调用 */
+  sendTask(targetAgentId: string, task: TaskRequest): Promise<TaskHandle>;
+
+  /**
+   * 等待任务结果。
+   *   - OASN: 轮询（或 SSE 升级，见设计文档 §11.8）
+   *   - TIM:  阻塞等待 C2C `openagent_task_result` 消息
+   *
+   * 超时由 `options.timeoutMs` 控制（OASN 与 effective_timeout_ms 协调，见 §11.3）。
+   */
+  waitForTaskResult(
+    handle: TaskHandle,
+    options: { timeoutMs: number; signal?: AbortSignal; onProgress?: ProgressCallback },
+  ): Promise<TaskResult>;
+}
+
+/** Agent 发现 —— 两种 transport 都实现（TIM 把 channel 列表伪装成 AgentCard） */
+export interface DiscoveryTransport {
+  searchAgents(query: SearchQuery): Promise<SearchResult>;
+  getAgent(agentId: string): Promise<AgentCard | null>;
+  /** Category 树（OASN-only；TIM 实现可返回空树） */
+  getCategories?(params?: { agentType?: string }): Promise<CategoryTree>;
+}
+
+/** Agent 注册与管理 —— OASN-only */
+export interface RegistrationTransport {
+  /** `POST /api/agents/register`。install_id 由 §11.7 防孤儿机制提供 */
+  registerAgent(
+    platform: string,
+    params?: { installId?: string; deviceHint?: string },
+  ): Promise<RegisterResult>;
+  claimAgent(params: ClaimParams): Promise<ClaimResult>;
+  getAgentStatus(agentId: string): Promise<AgentStatusResult>;
+  updateAgentCard(agentId: string, patch: AgentCardPatch): Promise<AgentCard>;
+  getCurrentOwner?(): Promise<OwnerInfo | null>;
+}
+
+/** 文件 / Artifact —— OASN-only */
+export interface FileTransport {
+  /** 上传文件，返回 file_ref（含 LRU 缓存，见设计文档 §11.4） */
+  uploadFile(file: UploadFileParams): Promise<UploadFileResult>;
+  /** 下载 Artifact 二进制内容 */
+  downloadArtifact(artifactId: string): Promise<DownloadArtifactResult>;
+}
+
+/** IM 群聊与频道管理 —— TIM-only */
+export interface IMChannelTransport {
+  /** TIM-only 事件订阅 */
+  on(event: TimOnlyTransportEvent, handler: (...args: any[]) => void): void;
+  off(event: TimOnlyTransportEvent, handler: (...args: any[]) => void): void;
+
+  /**
+   * 接收远程 agent 任务（T3 路径）。
+   * OASN 无此能力 —— ClientAgent 是消费者侧，不接收外来 Invocation。
+   */
+  onTaskReceived(handler: TaskHandler): void;
+
+  /** 群聊发文本（支持 @ ） */
+  sendGroupMessage(
+    channelId: string,
+    text: string,
+    atUserList?: string[],
+  ): Promise<{ ok: boolean; messageId: string }>;
+
+  /** 拉取群历史 */
+  fetchGroupHistory(channelId: string, count?: number): Promise<TransportMessage[]>;
+
+  // 以下方法在当前业务里 DORMANT —— 接口保留为 optional，运行时不激活
+  listChannels?(): Promise<ChannelInfo[]>;
+  searchChannels?(keyword: string): Promise<ChannelInfo[]>;
+  joinChannel?(channelId: string): Promise<{ success: boolean; message: string }>;
+  leaveChannel?(channelId: string): Promise<{ success: boolean; message: string }>;
+  getMembers?(channelId: string): Promise<MemberInfo[]>;
+  createChannel?(name: string, desc?: string): Promise<{ success: boolean; channelId: string }>;
+  getChannelSkill?(channelId: string): Promise<string | null>;
+  setChannelSkill?(channelId: string, skill: string): Promise<{ success: boolean }>;
+}
+
+// ═══════════════════════════════════════════════════════════════
+// 实现侧聚合类型
+// ═══════════════════════════════════════════════════════════════
+
+/**
+ * OASN transport 的实际能力集合 ——
+ * 含核心生命周期 + 任务调用 + 发现 + 注册/认领 + 文件，不含 IM 群聊。
+ */
+export type OasnTransport =
+  & CoreTransport
+  & TaskTransport
+  & DiscoveryTransport
+  & RegistrationTransport
+  & FileTransport;
+
+/**
+ * TIM transport 的实际能力集合 ——
+ * 含核心生命周期 + 任务调用 + 发现 + IM 群聊，不含 OASN 注册/文件。
+ */
+export type TimTransport =
+  & CoreTransport
+  & TaskTransport
+  & DiscoveryTransport
+  & IMChannelTransport;
+
+/**
+ * 上层调用方持有的联合类型。
+ *
+ * 使用规范：
+ *   - 只用 Core/Task/Discovery 能力 → 直接接收 AgentTransport
+ *   - 需要 OASN-only 能力（注册/文件）→ 通过 `transport.transportType === 'oasn'` narrow
+ *   - 需要 TIM-only 能力（群聊/T3）→ 通过 `transport.transportType === 'tim'` narrow
+ *
+ * 不要使用 `transport.foo?.()` 防御式调用 —— 用 transportType 在编译期 narrow。
+ */
+export type AgentTransport = OasnTransport | TimTransport;

package/src/types/openclaw.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Minimal type declarations for openclaw peer dependency.
+ * Only declares the APIs actually used by this plugin.
+ *
+ * These stubs allow `tsc --noEmit` to pass in environments where
+ * openclaw is not installed (e.g. npm pack / CI).
+ * At runtime, the real openclaw package provides the implementations.
+ */
+
+declare module 'openclaw/plugin-sdk/infra-runtime' {
+  export function resolvePreferredOpenClawTmpDir(): string;
+}
+
+declare module 'openclaw/plugin-sdk/plugin-entry' {
+  export interface OpenClawPluginApi {
+    runtime?: import('openclaw/plugin-sdk/core').PluginRuntime;
+    registerChannel(opts: { plugin: unknown }): void;
+    registerTool(factory: unknown, opts?: { optional?: boolean }): void;
+    registerHook?(hook: unknown): void;
+    registerHttpRoute(params: {
+      path: string;
+      auth: 'gateway' | 'plugin';
+      match?: 'exact' | 'prefix';
+      replaceExisting?: boolean;
+      handler: (req: import('node:http').IncomingMessage, res: import('node:http').ServerResponse) => Promise<boolean> | boolean;
+    }): void;
+    registrationMode?: string;
+  }
+}
+
+declare module 'openclaw/plugin-sdk/channel-config-schema' {
+  export function buildChannelConfigSchema(schema: unknown): unknown;
+}
+
+declare module 'openclaw/plugin-sdk/core' {
+  export interface PluginRuntime {
+    version?: string;
+    channel: {
+      routing: {
+        resolveAgentRoute(params: {
+          cfg: unknown;
+          channel: string;
+          accountId: string;
+          peer: { kind: string; id: string };
+        }): {
+          agentId?: string;
+          sessionKey?: string;
+          mainSessionKey?: string;
+        };
+      };
+      reply: {
+        finalizeInboundContext(ctx: unknown): unknown;
+        createReplyDispatcherWithTyping(opts: {
+          deliver: (
+           payload: { text?: string; mediaUrl?: string; mediaUrls?: string[] },
+           meta?: { kind?: string },
+         ) => Promise<void>;
+          onError?: (err: unknown, info: { kind: string }) => void;
+        }): {
+          dispatcher: unknown;
+          replyOptions: Record<string, unknown>;
+          markDispatchIdle: () => void;
+        };
+        withReplyDispatcher(opts: { dispatcher: unknown; run: () => Promise<void> }): Promise<void>;
+        dispatchReplyFromConfig(opts: {
+          ctx: unknown;
+          cfg: unknown;
+          dispatcher: unknown;
+          replyOptions?: Record<string, unknown>;
+        }): Promise<void>;
+      };
+      session: {
+        resolveStorePath(store: unknown, opts: { agentId: string }): string;
+        recordInboundSession(opts: {
+          storePath: string;
+          sessionKey?: string;
+          ctx: unknown;
+          updateLastRoute?: {
+            sessionKey?: string;
+            channel: string;
+            to: string;
+            accountId: string;
+          };
+          onRecordError?: (err: unknown) => void;
+        }): Promise<void>;
+      };
+    };
+    events: {
+      onAgentEvent(listener: (evt: {
+        sessionKey?: string;
+        stream?: string;
+        data: { phase?: string; partialResult?: unknown; [key: string]: unknown };
+        [key: string]: unknown;
+      }) => void): () => void;
+    };
+  }
+}

package/src/types/tencentcloud-chat.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Type declarations for local SDK modules
+ *
+ * These are JS-only modules bundled in src/sdk/ that need
+ * minimal type stubs for TypeScript compilation.
+ */
+
+declare module '../sdk/modules/group-module.js' {
+  const GroupModule: unknown;
+  export default GroupModule;
+}
+
+declare module '../sdk/node-env/index.js' {
+  // Side-effect only module — installs ws WebSocket, localStorage, rejection handler
+}