@adep/client — AgentDeploy 实时客户端

实时通道订阅库（任务单 RT-005）：换票 → 建连 → 订阅 → 断线自动重连 → 对称心跳。独立于页面框架，可被非 Page 场景（如 widget 卡片渲染）复用。

npm install @adep/client
# 或
pnpm add @adep/client

能力总览

• 票据换连：向平台换取实时票据（ticket），以票据建立 WebSocket 连接
• 订阅 / 取消订阅：按通道订阅实时事件
• 自动重连：断线后自动重连并恢复订阅状态
• 对称心跳：客户端与服务端对称心跳保活

用法

import { RealtimeClient } from '@adep/client'

const client = new RealtimeClient({ server: 'wss://api.example.com' })
await client.connect()

const off = client.subscribe('room:1', (msg) => {
  console.log('收到实时消息', msg)
})

// 不需要时取消订阅并关闭
off()
await client.disconnect()

说明

• 仅依赖 @adep/types 提供消息类型契约。
• 协议细节（票据端点 / 心跳间隔 / 重连退避）见 packages/docs/features/realtime.md。